MCP Server

OpenAPI to Model Context Protocol Bridge

Checking...

🔌 OpenAPI 橋接

自動將 Swagger/OpenAPI 規格轉換為 MCP 工具，讓 AI 能直接呼叫你的 API

🔐 多重認證

支援 7 種認證策略：API Key、Basic Auth、Bearer Token、OAuth 2.0 等

⚡ 企業級功能

Rate Limiter、Circuit Breaker、Health Check、Graceful Shutdown

🛡️ 安全防護

Security Headers、Request Sanitization、TLS 支援、JWT 驗證

快速開始

安裝相依套件

npm install

設定環境變數

cp .env.example .env
# 編輯 .env 設定 API_BASE_URL 和認證資訊

編譯與啟動

# 開發模式 (HTTP)
npm run dev:http

# 正式環境
npm run build && npm start -- --enable-http

測試連線

# 健康檢查
curl http://localhost:3000/health

# MCP 初始化
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"clientName":"test"}}'

API 端點

POST/mcp - MCP JSON-RPC 端點
GET/health - 健康檢查（Liveness Probe）
GET/health/ready - Readiness Probe
GET/.well-known/oauth-protected-resource - OAuth Discovery

MCP 工具列表

工具名稱	說明
`OpenAPI_ListEndpoints`	列出所有 API 端點
`OpenAPI_GetEndpoint`	取得端點詳細資訊
`OpenAPI_GetRequestBody`	取得請求 Body Schema
`OpenAPI_GetResponseSchema`	取得回應 Schema
`OpenAPI_SearchSchema`	搜尋 Schema 定義
`OpenAPI_ListSecurity`	列出安全性定義
`OpenAPI_GetCodeSnippet`	產生程式碼範例
`OpenAPI_ExecuteRequest`	執行 API 請求

環境變數

變數	必填	說明
`API_BASE_URL`	是	後端 API 基礎 URL
`AUTH_STRATEGY`	否	認證策略 (none/api-key/bearer/...)
`API_KEY`	視策略	API Key (api-key 策略時需要)
`SWAGGER_SOURCE`	否	Swagger 來源 (local/remote)
`MCP_HTTP_PORT`	否	HTTP 埠號 (預設 3000)

完整設定請參考 .env.example 檔案

與 AI 整合

Claude Desktop

在 claude_desktop_config.json 新增 MCP Server 設定

{
  "mcpServers": {
    "my-api": {
      "command": "node",
      "args": ["build/index.js"]
    }
  }
}

HTTP 模式

啟動 HTTP 服務後，設定 URL 為 http://localhost:3000/mcp