OpenAPI MCP 服务器

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

特性

当前实现状态：

• ✅ 标准 I/O (stdio)
• ✅ 服务器发送事件 (SSE)
• ✅ OpenAPI/REST 端点

运行模式

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

• stdio: 作为标准 I/O 服务器运行
• sse: 作为服务器发送事件服务器运行 (端口 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）现在都已实现，可以根据你的需要互换使用。