jawz/NixOS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

init

Browse Source
This commit is contained in:
Danilo Reyes
2026-01-30 22:48:02 -06:00
parent 2a418c4394
commit 527fad8da0
9 changed files with 410 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
specs/001-mcp-server/quickstart.md Normal file
View File

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