快速 MCP 服务器

一个轻量级的 MCP（模型上下文协议）服务器实现，通过 SSE 接口暴露自定义工具，以便与 AI 客户端集成。

目录

• 概述
• 功能
• 先决条件
• 快速入门
  • 构建 Docker 镜像
  • 启动容器
• 使用方法
  • 连接 MCP 客户端
  • 可用端点
• 配置
• 开发
• 故障排除
• 许可协议

概述

此仓库提供一个简单的 MCP 服务器，实现自定义工具（例如天气预警和预报）并将其通过 SSE 接口暴露出来。它可以使用 Docker 容器快速部署，并与支持 MCP 协议的客户端无缝集成。

功能

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

先决条件

• Docker ≥ 20.10
• Docker Compose ≥ 1.29

快速入门

克隆仓库并进入项目目录：

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

使用方法

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