Quickstart: MCP Server for Repo Maintenance

Prereqs: Python 3.12, uv or pip, and Codex CLI installed locally.
Install: From repo root, cd scripts/mcp-server and run uv pip install -e . (or pip install -e . if uv unavailable).
Run tests: pytest --maxfail=1 --disable-warnings -q (adds lint/format checks via ruff/black in CI).
Launch MCP server: python -m mcp_server.server (stdio mode).
Connect Codex CLI: Configure Codex to use the local MCP endpoint (stdin transport) and run listTools to verify catalog.
Docs alignment: If adding/updating tools, run syncDocs to confirm docs match; update docs/ MCP section accordingly.
CI behavior: Gitea runs lint/format/tests when scripts/** or docs/** change; fix failures before merging.