MCP Python Monrepo
Python monorepo 模型上下文协议(MCP) 服务器——共享核心、多服务器包、FastAPI+uv。
快速开始
# From repo root
uv sync
uv run python -m echo_server --transport=http --port=3000
# In another terminal:
curl http://localhost:3000/health文档和跟踪
| 文件 | 目的 |
|---|---|
| MCP_PYTHON_DEV.md | 完整的开发指南(设置、阶段、代码) |
| PROGRESS.md | 活动跟踪:已开始/正在进行/已完成/待定 |
| prompt.md | 代理开始下一次会话 |
| claude.md | 代码审查和质量指南 |
布局
packages/core— mcp核心:BaseMCPServer,TransportType,HTTP sidecar(GET /信息页面,/health,/info,/mcp)packages/servers/echo_server--参考服务器(端口3000)packages/servers/api_server--树桩(3001)packages/servers/docs_server--树桩(3002)packages/servers/c4_generator--树桩(3003)packages/servers/mermaid_generator--树桩(3004)tests/--pytest测试
命令(Makefile)
make install--紫外同步make lint/make format/make typecheck/make testmake dev-echo-http--端口3000上的Echo服务器make docker-up--Docker Compose(目前仅支持echo服务器)
技术栈
Python 3.12+, mcp[cli] (FastMCP)、Pydantic v2、FastAPI、Uvicorn、, 紫外线 (工作区+deps)、pytest、ruff、mypy。
