Fast MCP Server

🚀 快速 MCP 服务器

本项目是一个轻量级的 MCP（模型上下文协议）服务器实现，通过 SSE 接口将自定义工具暴露出来，可与 AI 客户端实现无缝集成，为用户提供便捷的工具调用体验。

🚀 快速开始

此仓库提供了一个简单的 MCP 服务器，能实现自定义工具（如天气预警和预报），并通过 SSE 接口将其暴露。它可借助 Docker 容器快速部署，与支持 MCP 协议的客户端无缝集成。 克隆仓库并进入项目目录：

git clone git@github.com:kongo97/fast-mcp-server.git
cd fast-mcp-server

构建 Docker 镜像

docker compose build

此命令会使用提供的 Dockerfile 为 MCP 服务器构建 Docker 镜像。

启动容器

docker compose up -d

此命令将执行以下操作：

• 拉取/构建镜像
• 以分离模式启动容器
• 将主机的端口 8100 映射到容器的端口 8100

若要停止并删除容器，请运行：

docker compose down

✨ 主要特性

• 通过 SSE 接口将自定义工具作为 MCP 端点暴露出来。
• 利用 Docker Compose 进行容器化，便于快速部署。
• 支持端口和主机地址的配置。
• 包含示例工具（如天气预警和预报）。

📦 安装指南

先决条件

• Docker ≥ 20.10
• Docker Compose ≥ 1.29

💻 使用示例

连接 MCP 客户端

配置您的 MCP 兼容客户端（如 Claude Desktop），通过 SSE 接口连接到以下地址：

http://localhost:8100/sse

在 docs 文件夹中，您能找到与 Claude Desktop 配合使用的简单配置示例（claude_desktop_config.json）。

可用端点

📚 详细文档

配置

您可通过在 docker-compose.yml 或直接在容器中设置环境变量，来自定义服务器端口和主机地址：

services:
  mcp-server:
    environment:
      - MCP_PORT=8100         # 默认端口
      - MCP_HOST=0.0.0.0      # 绑定地址

开发

1. 在 src/server.py（或其他您选择的文件）中编辑或添加您的 MCP 工具。
2. 重建并重新启动容器：

   docker compose build
   docker compose up -d
   

3. 检查日志中的错误信息：

   docker compose logs -f
   

故障排除

• 访问 /sse 时返回 404：请确保服务器已绑定到正确的端口和路径。
• 连接被拒绝：请验证 Docker 是否在运行且容器状态正常：

  docker ps
  docker logs simple-mcp-server
  

• 客户端错误：检查客户端配置中的 SSE URL 和协议版本是否正确。

📄 许可证

文档中未提及具体的许可协议内容。若您需要了解，请进一步查阅相关资料。