Fast MCP Server

Fast MCP Server

一个轻量级 MCP（Model Context Protocol）服务实现，通过 SSE 向 AI 客户端提供自定义工具。

目录

• 概述
• 功能
• 前提条件
• 开始使用
  • 构建 Docker 镜像
  • 启动容器
• 使用方法
  • 连接 MCP 客户端
  • 可用端点
• 配置
• 开发
• 故障排除
• 许可证

概述

此代码库提供了一个简单的 MCP 服务，可实现自定义工具（例如天气查询），并通过服务器发送事件（SSE）提供这些工具。它可以在 Docker 容器中运行，便于快速部署，并能与支持 MCP 协议的客户端无缝集成。

功能

• 通过 SSE 将工具作为 MCP 端点提供
• 使用 Docker Compose 容器化，便于部署
• 可配置端口和主机
• 包含示例工具（例如天气预警和预报）

前提条件

• Docker ≥ 20.10
• Docker Compose ≥ 1.29

开始使用

克隆代码库并进入项目目录：

git clone [email protected]:kongo97/fast-mcp-server.git
cd fast-mcp-server

构建 Docker 镜像

docker compose build

这将使用提供的 Dockerfile 构建 MCP 服务镜像。

启动容器

docker compose up -d

此命令将：

• 拉取/构建镜像
• 在后台模式下启动容器
• 将主机上的端口 8100 映射到容器中的端口 8100

如需停止并移除容器，请运行：

docker compose down

使用方法

连接 MCP 客户端

配置兼容 MCP 的客户端（例如 Claude Desktop），通过 SSE 连接至：

http://localhost:8100/sse

在 docs 文件夹中，你可以找到一个与 Claude Desktop 兼容的简单配置文件（claude_desktop_config.json）

可用端点

方法	路径	说明
GET	/sse	打开用于 MCP 通信的 SSE 流
POST	/sse	通过 SSE 发送 JSON-RPC 请求

配置

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

services:
  mcp-server:
    environment:
      - MCP_PORT=8100         # default port
      - MCP_HOST=0.0.0.0      # bind address

开发

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 和协议版本是否正确。