🚀 简单 MCP 服务器

这是一个轻量级的 MCP（模型上下文协议）服务器实现，借助 SSE 提供自定义工具，可与 AI 客户端实现无缝集成，为用户带来便捷的使用体验。

🚀 快速开始

此仓库提供了一个简单的 MCP 服务器，能实现自定义工具（如天气警报），并通过 SSE 推送事件。它支持使用 Docker 容器快速部署，可与支持 MCP 协议的客户端完美集成。

首先，克隆仓库并进入项目目录：

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

构建 Docker 镜像

docker compose build

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

启动容器

docker compose up -d

该命令会执行以下操作：

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

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

docker compose down

✨ 主要特性

• 通过 SSE 推送事件，将自定义工具作为 MCP 端点暴露出来。
• 支持使用 Docker Compose 进行容器化部署，方便快速启动和运行。
• 端口和主机均可进行配置。
• 已包含示例工具（如天气警报和预报）。

📦 安装指南

先决条件

• Docker ≥ 20.10
• Docker Compose ≥ 1.29

💻 使用示例

连接 MCP 客户端

配置您的 MCP 兼容客户端（如Claude桌面版）通过 SSE 连接到：

http://localhost:8100/sse

在 docs 文件夹中，您能找到一个与 Claude 桌面兼容的简单配置（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
   

故障排除

• 404 在 /sse：请确保服务器绑定到正确的端口和路径。
• 连接被拒绝：确认 Docker 正在运行且容器状态正常：

  docker ps
  docker logs simple-mcp-server
  

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

📄 许可证

文档中未明确提及具体的许可证内容。