Python Monorepo服务

一个用于Model Context Protocol (MCP)服务器的Python monorepo,提供共享核心和多个服务器包,基于FastAPI和uv。

  • by rapidcoderx
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 rapidcoderx/mcp-py-monorepo

使用说明

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 test
  • make 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。