AI导哈

MCP服务器模板

一个包含CI/CD、Docker和文档即代码的DevOps友好型MCP服务器模板，用于快速构建和部署MCP服务。

  • by hsiangjenli
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 hsiangjenli/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 .

  2. 运行容器：

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

  3. 运行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

相关 MCP