lmiranda
2d51df7a42
Phase 1b: Rename all ~94 commands across 12 plugins to /<noun> <action> sub-command pattern. Git-flow consolidated from 8→5 commands (commit variants absorbed into --push/--merge/--sync flags). Dispatch files, name: frontmatter, and cross-reference updates for all plugins. Phase 2: Design documents for 8 new plugins in docs/designs/. Phase 3: Scaffold 8 new plugins — saas-api-platform, saas-db-migrate, saas-react-platform, saas-test-pilot, data-seed, ops-release-manager, ops-deploy-pipeline, debug-mcp. Each with plugin.json, commands, agents, skills, README, and claude-md-integration. Marketplace grows from 12→20. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
63 lines
2.1 KiB
Markdown
63 lines
2.1 KiB
Markdown
# debug-mcp
|
|
|
|
MCP server debugging, inspection, and development toolkit.
|
|
|
|
## Overview
|
|
|
|
This plugin provides tools for diagnosing MCP server issues, testing tool invocations, analyzing server logs, inspecting configurations and dependencies, and scaffolding new MCP servers. It is essential for maintaining and developing MCP integrations in the Leo Claude Marketplace.
|
|
|
|
## Commands
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `/debug-mcp status` | Show all MCP servers with health status |
|
|
| `/debug-mcp test` | Test a specific MCP tool call |
|
|
| `/debug-mcp logs` | View recent MCP server logs and errors |
|
|
| `/debug-mcp inspect` | Inspect MCP server config and dependencies |
|
|
| `/debug-mcp scaffold` | Generate MCP server skeleton project |
|
|
|
|
## Agent
|
|
|
|
| Agent | Model | Mode | Purpose |
|
|
|-------|-------|------|---------|
|
|
| mcp-debugger | sonnet | default | All debug-mcp operations: inspection, testing, log analysis, scaffolding |
|
|
|
|
## Skills
|
|
|
|
| Skill | Description |
|
|
|-------|-------------|
|
|
| mcp-protocol | MCP stdio protocol specification, JSON-RPC messages, tool/resource/prompt definitions |
|
|
| server-patterns | Python MCP server directory structure, FastMCP pattern, config loader, entry points |
|
|
| venv-diagnostics | Virtual environment health checks: existence, Python binary, packages, imports |
|
|
| log-analysis | Common MCP error patterns with root causes and fixes |
|
|
| visual-header | Standard command output header |
|
|
|
|
## Architecture
|
|
|
|
```
|
|
plugins/debug-mcp/
|
|
├── .claude-plugin/
|
|
│ └── plugin.json
|
|
├── commands/
|
|
│ ├── debug-mcp.md # Dispatch file
|
|
│ ├── debug-mcp-status.md
|
|
│ ├── debug-mcp-test.md
|
|
│ ├── debug-mcp-logs.md
|
|
│ ├── debug-mcp-inspect.md
|
|
│ └── debug-mcp-scaffold.md
|
|
├── agents/
|
|
│ └── mcp-debugger.md
|
|
├── skills/
|
|
│ ├── mcp-protocol.md
|
|
│ ├── server-patterns.md
|
|
│ ├── venv-diagnostics.md
|
|
│ ├── log-analysis.md
|
|
│ └── visual-header.md
|
|
├── claude-md-integration.md
|
|
└── README.md
|
|
```
|
|
|
|
## License
|
|
|
|
MIT License - Part of the Leo Claude Marketplace.
|