Docker化的MCP服务器模板

该仓库提供了一个可重用的模板，用于实现 模型上下文协议 (MCP) 的 Python 服务器，该服务器运行在 Docker 容器中，并利用服务器发送事件 (SSE) 进行实时通信。该模板使用 FastMCP 库构建，可以轻松地与大型语言模型 (LLM) 集成。

什么是 MCP？

模型上下文协议 (MCP) 是一种专门为与大型语言模型 (LLM) 交互而设计的标准化协议。 MCP 允许应用程序清楚地分离提供上下文（数据和功能）与实际 LLM 交互的关注点。 MCP 服务器公开：

• 资源 (Resources)：向 LLM 提供数据（类似于 GET 端点）。
• 工具 (Tools)：允许 LLM 执行操作或计算（类似于 POST 端点）。
• 提示 (Prompts)：用于与 LLM 进行结构化交互的可重用模板。

此模板演示了一个在 Docker 容器中运行的、生产就绪的 MCP 服务器，该服务器利用服务器发送事件 (SSE) 进行实时通信。

项目结构

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

快速开始

使用 Docker Compose 构建和运行

docker-compose up --build

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

http://localhost:3000/sse

直接运行（不使用 Docker）

或者，您可以使用 Python 直接运行服务器。 首先，安装依赖项：

pip install -r src/requirements.txt

然后运行服务器：

python src/server.py

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

http://localhost:3000/sse

使用示例

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

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

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

资源

• MCP 文档
• MCP 规范
• 服务器发送事件 (SSE)