Dockerized MCP Server Template

🚀 Dockerized MCP 服务器模板

本仓库提供了一个可复用的模板，用于借助 Docker 容器运行的 Python 服务器实现模型上下文协议 (MCP)，并运用 Server-Sent Events (SSE) 实现实时通信。该模板基于 FastMCP 库构建，能轻松实现与大型语言模型 (LLMs) 的集成。

🚀 快速开始

使用 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 的 Python 服务器。
• 基于 Docker 容器，便于部署和管理。
• 利用 Server-Sent Events (SSE) 实现实时通信。
• 基于 FastMCP 库，方便与大型语言模型集成。

📦 安装指南

使用 Docker Compose

docker-compose up --build

不使用 Docker

pip install -r src/requirements.txt

💻 使用示例

基础用法

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

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

📚 详细文档

什么是 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

📄 资源

• MCP 文档
• MCP 规范
• Server-Sent Events (SSE)