Simple MCP Server

Simple MCP Server

site icon
2025.04.23 0
PythonMCP 服务器SSE 协议AI 集成开发效率
Simple MCP Server 是一个轻量级的 MCP(Model Context Protocol)服务器实现,通过 SSE(Server-Sent Events)暴露自定义工具,以便与 AI 客户端集成。它提供了简单的部署方式(Docker 容器化)和可配置的端口和主机设置,适用于需要快速集成 MCP 协议的场景。
View on GitHub

Overview

基本能力

产品定位

Simple MCP Server 是一个轻量级的 MCP 服务器,旨在通过 SSE 协议暴露自定义工具,方便与支持 MCP 协议的客户端(如 Claude Desktop)集成。

核心功能

  • 通过 SSE 暴露 MCP 端点
  • 支持 Docker 容器化部署
  • 可配置的端口和主机设置
  • 包含示例工具(如天气警报和预报)

适用场景

  • 需要快速集成 MCP 协议的 AI 客户端开发
  • 需要自定义工具并通过 SSE 协议暴露的场景
  • 需要轻量级、容器化部署的 MCP 服务器

工具列表

  • /sse:通过 GET 或 POST 方法进行 MCP 通信的 SSE 流端点

常见问题解答

  • 404 on /sse:确保服务器绑定到正确的端口和路径。
  • Connection refused:检查 Docker 是否运行以及容器是否健康。
  • Client errors:检查客户端配置中的 SSE URL 和协议版本是否正确。

使用教程

使用依赖

  • Docker ≥ 20.10
  • Docker Compose ≥ 1.29

安装教程

  1. 克隆仓库并进入项目目录: bash git clone [email protected]:kongo97/simple-mcp-server.git cd simple-mcp-server
  2. 构建 Docker 镜像: bash docker compose build
  3. 启动容器: bash docker compose up -d
  4. 停止并移除容器: bash docker compose down

调试方式

  1. 检查日志: bash docker compose logs -f
  2. 检查容器状态: bash docker ps docker logs simple-mcp-server

许可证

该项目遵循 License 开源许可条款。