MCP服务器实现

模型上下文协议 (MCP) 作为一个开放标准，旨在促进语言模型和客户端应用程序之间的通信。其模块化架构允许开发者构建、部署和交互能够管理上下文、数据流和基于事件的通信的服务器。这种开放性激发了社区的努力，以创建可访问、可扩展和安全的解决方案，从而连接各种平台和框架。

本仓库包含两个 MCP (消息控制协议) 服务器的实现：

1. FastAPI with SSE - 使用 FastAPI 和服务器发送事件 (Server-Sent Events) 的 Web 服务器实现
2. Standalone MCP - 用于 Docker 容器的直接 stdin/stdout 实现

MCP 功能

两种实现都提供以下 MCP 功能：

1. 资源 (Resources)

   • echo://{message} - 将消息作为资源回显

2. 工具 (Tools)

   • echo_tool - 将消息作为工具回显
   • demo_tool - 通过添加两个数字来演示工具功能

3. 提示词 (Prompts)

   • echo_prompt - 创建一个回显提示词

入门指南

前提条件

• Python 3.10+
• MCP >= 0.3.0
• Docker (用于容器化部署)
• FastAPI 和 Uvicorn (用于 SSE 实现)

安装

克隆此仓库并导航到项目目录：

git clone git@github.com:AMasetti/MCP-SSE-Custom-Server.git
cd mcp-server-implementations

SSE 实现

SSE (服务器发送事件) 实现通过 HTTP 提供实时数据流功能。这对于从 AI 模型流式传输响应特别有用。

构建和运行

您可以使用 Docker 或直接使用 uvicorn 运行 SSE 服务器：

# 使用 Docker
make build-sse
make run-sse

# 或者直接使用 uvicorn
uvicorn app.main:app --host 0.0.0.0 --port 8000

服务器将在 http://localhost:8000 上可用。

配置 Claude Desktop

要将 SSE 服务器添加到 Claude Desktop，请将以下内容添加到您的配置文件：

{
  "mcpServers": {
    "example-sse": {
      "url": "http://localhost:8000/sse",
      "env": {}
    }
  }
}

Standalone MCP 实现

Standalone 实现提供了一个简单的 stdin/stdout 接口，使其非常适合与 Claude Desktop 或类似应用程序直接集成。

构建和运行

# 使用 Make 命令
make build-local
make run-local

# 或者直接使用 Docker
docker build -t mcp/echo -f Dockerfile.mcp .
docker run -i --rm mcp/echo

配置 Claude Desktop

将以下内容添加到您的 Claude Desktop 配置文件：

{
  "mcpServers": {
    "echo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/echo"
      ]
    }
  }
}

项目结构

.
├── app/
│   ├── mcp_server.py    # 核心 MCP 服务器实现
│   └── sse.py           # 使用 Starlette 的 SSE 实现
├── Dockerfile.mcp       # Standalone MCP 的容器配置
├── Dockerfile.sse       # SSE 服务器的容器配置
└── Makefile            # 构建和运行命令

API 端点 (SSE 实现)

• GET / - 返回简单问候语的根端点
• GET /sse/ - 用于建立实时连接的 SSE 端点
• POST /messages/ - 用于向连接的客户端发送消息的端点

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目根据 MIT 许可证授权 - 有关详细信息，请参阅 LICENSE 文件。