OpenAPI MCP 服务器

这是一个您可以作为构建自己的MCP服务器起点的示例项目。该示例中的加法函数演示了如何在所有三种协议中实现处理程序。

功能

当前实现状态：

• ✅ 标准输入输出（stdio）
• ✅ Server-Sent Events（SSE）
• ✅ OpenAPI/REST 端点

运行模式

服务器支持三种不同的运行模式，由 MODE 环境变量控制：

• stdio：以标准I/O服务器运行
• sse：以Server-Sent Events服务器运行（端口8001）
• openapi：以OpenAPI/REST服务器运行（端口8002）

构建和运行

使用 Docker Compose

1. 构建容器：

docker compose build

2. 运行特定服务：

# 同时运行所有服务
docker compose up

# 仅运行SSE服务器
docker compose up sse-mcp-server

# 仅运行OpenAPI服务器
docker compose up openapi-mcp-server

直接使用 Docker

您也可以直接使用Docker运行该服务器：

# 在stdio模式下运行
docker run -i --rm -e MODE=stdio 3loc/openapi-mcp-server

# 在SSE模式下运行
docker run -p 8001:8000 --rm -e MODE=sse 3loc/openapi-mcp-server

# 在OpenAPI模式下运行
docker run -p 8002:8000 --rm -e MODE=openapi 3loc/openapi-mcp-server

配置

服务器可以通过一个 mcp.json 文件进行配置。以下是一个示例配置：

{
  "mcpServers": {
    "stdio-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm", 
        "-i",
        "--name", "openapi-mcp-server",
        "-e", "MODE=stdio",
        "3loc/openapi-mcp-server"
      ]
    },
    "sse-mcp-server": {
      "url": "http://localhost:8001/sse"
    }
  }
}

开发

该项目为实现一个具有多种通信协议的MCP服务器提供了基础。所有三种模式（stdio、SSE和OpenAPI）现已实现，并可根据需要互换使用。