Openapi MCP Server 3wh

🚀 OpenAPI MCP 服務器

這是一個示例項目，可作為您構建自己的 MCP 服務器的起點。示例中的加法函數展示瞭如何在三種協議中實現處理程序。

🚀 快速開始

本項目提供了一個可用於構建自定義 MCP 服務器的示例，通過示例中的加法函數，您能瞭解如何在三種協議中實現處理程序。

✨ 主要特性

當前實現狀態：

• ✅ 標準輸入輸出（stdio）
• ✅ Server-Sent Events（SSE）
• ✅ OpenAPI/REST 端點

📦 安裝指南

使用 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

📚 詳細文檔

運行模式

服務器支持三種不同的運行模式，由 MODE 環境變量控制：

• stdio：以標準 I/O 服務器運行
• sse：以 Server-Sent Events 服務器運行（端口 8001）
• openapi：以 OpenAPI/REST 服務器運行（端口 8002）

配置

服務器可以通過一個 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）現已實現，並可根據需要互換使用。