OpenAPI MCP Server

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

特性

当前实现状态：

• ✅ 标准I/O（标准输入输出）
• ✅ 服务器发送事件（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），可以根据需要互换使用。