Dockerized MCP Server Template

Dockerized MCP Server Template

site icon
2025.04.10 0
PythonLLM 集成实时通信Docker 容器化开发效率
Dockerized MCP Server Template 是一个基于 Python 的服务器模板,实现了 Model Context Protocol (MCP),运行在 Docker 容器中,并使用 Server-Sent Events (SSE) 进行实时通信。该模板基于 FastMCP 库构建,便于与大型语言模型 (LLMs) 集成。MCP 协议旨在明确分离上下文提供(数据和功能)与 LLM 交互的职责,通过资源、工具和提示三种方式与 LLMs 交互。
View on GitHub

Overview

基本能力

产品定位

Dockerized MCP Server Template 是一个用于快速构建与大型语言模型 (LLMs) 交互的服务器模板,支持 Docker 容器化和实时通信。

核心功能

  1. Model Context Protocol (MCP) 实现
  2. 资源 (Resources):提供数据给 LLMs(类似于 GET 端点)。
  3. 工具 (Tools):允许 LLMs 执行操作或计算(类似于 POST 端点)。
  4. 提示 (Prompts):可重用的模板,用于与 LLMs 的结构化交互。
  5. 实时通信:使用 Server-Sent Events (SSE) 实现实时数据传输。
  6. Docker 支持:提供 Docker 容器化部署方案。
  7. FastMCP 库:基于 FastMCP 库构建,便于与 LLMs 集成。

适用场景

  1. LLM 集成开发:快速构建与 LLMs 交互的后端服务。
  2. 实时数据处理:需要实时通信的应用场景。
  3. 生产环境部署:通过 Docker 容器化实现生产环境的快速部署。

工具列表

  1. add 工具:一个示例工具,用于计算两个数字的和。

常见问题解答

  1. 如何访问服务器?:服务器默认运行在 http://localhost:3000/sse
  2. 如何安装依赖?:通过 pip install -r src/requirements.txt 安装依赖。
  3. 如何运行服务器?:可以通过 Docker Compose 或直接运行 Python 脚本启动服务器。

使用教程

使用依赖

  1. 确保已安装 Docker 和 Docker Compose(如果使用 Docker 运行)。
  2. 确保已安装 Python 3.x 和 pip(如果直接运行 Python 脚本)。

安装教程

使用 Docker Compose 运行

docker-compose up --build

直接运行(不使用 Docker)

  1. 安装依赖:
pip install -r src/requirements.txt
  1. 启动服务器:
python src/server.py

调试方式

  1. 检查服务器是否运行:访问 http://localhost:3000/sse,确认服务器是否正常响应。
  2. 查看日志:如果使用 Docker Compose,可以通过以下命令查看日志:
docker-compose logs
  1. 测试工具:通过 MCP 客户端请求测试工具功能,例如调用 add 工具。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。