Dockerized MCP 服务器模板

此仓库提供了一个可重用的模板，用于使用 Docker 容器运行的 Python 服务器实现模型上下文协议 (MCP)，并利用 Server-Sent Events (SSE) 进行实时通信。该模板基于 FastMCP 库构建，使与大型语言模型 (LLMs) 的集成变得简单易行。

##什么是 MCP？

模型上下文协议 (MCP) 是一种专门设计用于与大型语言模型交互的标准协议。MCP 允许应用程序明确区分为 LLM 提供上下文（数据和功能）与实际的 LLM 交互这两个关注点。MCP 服务器提供：

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

此模板展示了在 Docker 容器中运行的生产就绪 MCP 服务器，并利用 Server-Sent Events (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 规范
• Server-Sent Events (SSE)