Simple MCP Server

简易 MCP 服务

一个轻量级 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/simple-mcp-server.git
cd simple-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 和协议版本是否正确。