fix(docs): update stale mcp_server references for gitea-mcp migration

- DEBUGGING-CHECKLIST: gitea test uses gitea_mcp.server (not mcp_server)
- debug-mcp skills: generic module placeholder, gitea exception noted
- Removed orphan .doc-guardian-queue from projman

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
2026-02-08 19:33:09 -05:00
parent 30e424306c
commit 93d93fcf09
7 changed files with 20 additions and 9 deletions

View File

@@ -2,7 +2,7 @@
**Purpose:** Systematic approach to diagnose and fix plugin loading issues.
Last Updated: 2026-01-28
Last Updated: 2026-02-08
---
@@ -95,9 +95,9 @@ Manually test if the MCP server can start:
```bash
RUNTIME=~/.claude/plugins/marketplaces/leo-claude-mktplace
# Test Gitea MCP
# Test Gitea MCP (uses gitea-mcp package from registry)
cd $RUNTIME/mcp-servers/gitea
PYTHONPATH=. .venv/bin/python -c "from mcp_server.server import main; print('OK')"
.venv/bin/python -c "from gitea_mcp.server import main; print('OK')"
# Test NetBox MCP
cd $RUNTIME/mcp-servers/netbox

View File

@@ -43,6 +43,9 @@ The `.mcp.json` file in the project root defines all MCP servers:
}
}
}
**Note:** Most servers use `mcp_server.server` (local source).
Exception: gitea uses `gitea_mcp.server` (pip-installed package).
```
### MCP Server Lifecycle

View File

@@ -53,6 +53,9 @@ Execute `skills/visual-header.md` with context "Server Inspection".
- Args: ["-m", "mcp_server.server"]
- CWD: /path/to/mcp-servers/gitea
- Env file: ~/.config/claude/gitea.env
**Note:** The gitea server uses `gitea_mcp.server` (installed from package).
Other servers use `mcp_server.server` (local source).
```
### Phase 2: Dependencies (--deps)

View File

@@ -108,6 +108,9 @@ python-dotenv>=1.0.0
"cwd": "mcp-servers/<server_name>"
}
```
**Note:** Use `mcp_server.server` for new servers being scaffolded.
Exception: gitea uses `gitea_mcp.server` (pip-installed package).
3. Show the change and ask user to confirm before writing
### Phase 5: Completion

View File

@@ -20,6 +20,9 @@ mcp-servers/<name>/
└── README.md
```
**Exception:** The gitea server uses the `gitea-mcp` package from Gitea PyPI
instead of local source. Its module is `gitea_mcp`, not `mcp_server`.
## FastMCP Pattern (Recommended)
The FastMCP decorator pattern provides the simplest server implementation:

View File

@@ -55,9 +55,13 @@ This reports broken dependencies (missing or incompatible versions).
Verify the server's main module can be imported:
```bash
cd <server_cwd> && .venv/bin/python -c "import mcp_server.server" 2>&1
cd <server_cwd> && .venv/bin/python -c "import <module>.server" 2>&1
```
Where `<module>` is the server's Python module:
- gitea: `gitea_mcp` (pip-installed package)
- All others: `mcp_server` (local source)
Common failures:
| Error | Cause | Fix |
|-------|-------|-----|

View File

@@ -1,5 +0,0 @@
2026-01-30T14:32:53 | skills | /home/lmiranda/claude-plugins-work/plugins/projman/skills/setup-workflows.md | README.md
2026-01-30T14:32:53 | commands | /home/lmiranda/claude-plugins-work/plugins/projman/commands/setup.md | docs/COMMANDS-CHEATSHEET.md README.md
2026-01-30T14:32:54 | commands | /home/lmiranda/claude-plugins-work/plugins/projman/commands/debug.md | docs/COMMANDS-CHEATSHEET.md README.md
2026-01-30T14:32:54 | commands | /home/lmiranda/claude-plugins-work/plugins/projman/commands/test.md | docs/COMMANDS-CHEATSHEET.md README.md
2026-01-30T14:33:13 | commands | /home/lmiranda/claude-plugins-work/plugins/projman/commands/sprint-status.md | docs/COMMANDS-CHEATSHEET.md README.md