Api Wrapper MCP

🚀 API 包裝器 MCP 服務器

這是一個用於模型上下文協議（MCP）的通用 API 包裝器服務器。它能讓您輕鬆地將 REST API 包裝成 MCP 工具，這些工具可被 Claude 及其他 MCP 客戶端訪問。

✨ 主要特性

• 可藉助 YAML 配置文件輕鬆配置多個 API 端點。
• 支持 GET 和 POST 請求。
• 具備參數驗證功能，還能設置默認值。
• 支持通過環境變量進行身份驗證。
• 可自定義 API 調用的超時時間。

📦 安裝指南

此項目無需特別安裝，可直接按以下步驟運行。

💻 使用示例

基礎用法

1. 創建一個 YAML 配置文件來定義您的 API 端點（參見 example-config.yaml）。
2. 設置任何所需的 API 令牌作為環境變量。
3. 使用配置文件運行服務器：

# 構建服務器
go build -o api_wrapper

# 使用配置文件運行
./api_wrapper my-apis.yaml

高級用法

配置文件格式

配置文件使用 YAML 格式，結構如下：

# 服務器信息
server:
  name: "API 網關 MCP"
  description: "通用 API 網關，將 REST API 包裝為 MCP 工具"
  version: "1.0.0"

# 身份驗證
auth:
  token_env_var: "API_GATEWAY_TOKEN"  # 環境變量中的 API 令牌

# 工具定義
tools:
  - name: "tool-name"
    description: "工具描述"
    endpoint: "https://api.example.com/endpoint"
    method: "POST"  # 或 "GET"
    timeout: 30  # 秒為單位
    template: |
      {
        "param1": "{{variable1}}",
        "param2": {{variable2}}
      }
    # 對於 GET 請求，使用 query_params
    query_params:
      param1: "{{variable1}}"
      param2: "{{variable2}}"
    parameters:
      variable1:
        type: "string"
        description: "變量 1 的描述"
        required: true
      variable2:
        type: "number"
        description: "變量 2 的描述"
        default: 10

與 Claude Desktop 集成

要與 Claude Desktop 集成，請在 claude_desktop_config.json 中添加以下內容：

{
  "mcpServers": {
    "api-wrapper": {
      "command": "path/to/api_wrapper",
      "args": ["path/to/your-config.yaml"],
      "env": {
        "API_GATEWAY_TOKEN": "your-api-token"
      }
    }
  }
}

📚 詳細文檔

示例

查看 example-config.yaml 以獲取 API 配置示例。

環境變量

• 使用環境變量中指定的字段設置主要身份驗證令牌：auth.token_env_var。
• 您也可以在模板中引用其他環境變量，使用 {{env:VARIABLE_NAME}} 語法。