MCP Tw Gpss

Python MCP Template

一个DevOps友好的模板，包含CI/CD、Docker和文档即代码（DaC），用于构建MCP服务器

🚀 核心理念

此模板利用 fastmcp 和 快速API 无缝集成MCP功能，同时继承原始OpenAPI规范。

🌟 特性

• CI/CD集成：使用GitHub Actions自动化您的工作流程。
• Docker化环境：一致且可移植的开发和生产环境。
• 文档即代码：使用MkDocs自动生成和部署文档。该过程还利用了 openapi.json 文件，以确保API文档是最新的。
• FastAPI集成：使用OpenAPI支持构建强大的API。

🛠️ 入门指南

本地开发

1. 安装依赖项：

uv sync

1. 运行MCP服务器：

# stdio
uv run --with fastmcp fastmcp run mcp_tools/main.py

# http
uv run --with fastmcp fastmcp run mcp_tools/main.py --transport http

码头工人

1. 构建Docker镜像：

   docker build -t python-mcp-template:latest .

1. 运行容器：

   docker run -i --rm -p 8000:8000 python-mcp-template:latest

1. 运行MCP服务器：

{
  "mcpServers": {
    "python-mcp-template": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-p",
        "8000:8000",
        "python-mcp-template:latest"
      ]
    }
  }
}

📚 文档

• 文档是使用MkDocs构建的，并部署到GitHub Pages。

• 要在本地构建文档，请执行以下操作：

  chmod +x scripts/build_docs.sh
  scripts/build_docs.sh
  mkdocs build