Dockerized MCP Server Template

Docker 化 MCP 服务模板

此仓库提供了一个可复用的模板，用于构建基于 Python 的 Model Context Protocol（MCP） 服务。该服务运行在 Docker 容器中，并使用 Streamable HTTP 进行实时通信。此模板基于 Model Context Protocol（MCP）的 Python 实现，可轻松与大语言模型（LLM）集成。

什么是 MCP？

Model Context Protocol（MCP） 让你能够构建以安全、标准化的方式向 LLM 应用公开数据和功能的服务。

此模板展示了一个可用于生产环境的 MCP 服务，它运行在 Docker 容器中，并使用无状态 Streamable HTTP 进行实时通信。

项目结构

dockerized-mcp-server-template/
├── src/
│   ├── Dockerfile
│   ├── requirements.txt
│   └── server.py
├── docker-compose.yml
└── README.md

开始使用

使用 Docker Compose 构建并运行

docker-compose up --build

服务可通过以下地址访问：

http://localhost:8080/mcp

直接运行（不使用 Docker）

此外，你也可以使用 Python 直接运行服务。首先，安装依赖：

pip install -r src/requirements.txt

然后运行服务：

python src/server.py

服务可通过以下地址访问：

http://localhost:8080/mcp

使用示例

示例包含一个简单的 MCP 工具函数 add：

@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b

你可以通过 MCP 客户端请求调用此工具。

技术说明

此模板使用 Streamable HTTP 传输方式，该方式从 Python SDK v1.8.0 起在 Model Context Protocol 中提供（https://github.com/modelcontextprotocol/python-sdk）。

为什么使用 Streamable HTTP？

Streamable HTTP 相较于之前的 SSE 传输方式有了显著改进，它支持无状态运行，使 MCP 兼容无服务器架构和标准 Web 基础设施。这种方式无需持久连接，从而提高了资源利用率和成本效益，同时也为开发者提供了更简单直接的实现方式。最终得到的 MCP 服务更易于部署、扩展性更好、资源利用率更高，同时不会牺牲功能。

资源

• MCP 文档
• MCP 规范
• Python SDK