API Wrapper MCP Server

API Wrapper MCP サーバー

これは、Model Context Protocol（MCP）用の汎用 API ラッパーサーバーです。REST API を簡単に MCP ツールとしてラップし、Claude やその他の MCP クライアントから利用できるようにします。

機能

• 複数の API エンドポイントを簡単に YAML で設定
• GET リクエストと POST リクエストの両方をサポート
• パラメーターの検証とデフォルト値
• 環境変数による認証
• API 呼び出しのカスタムタイムアウト

使用方法

1. API エンドポイントを定義する YAML 設定ファイルを作成します（example-config.yaml を参照）
2. 必要な API トークンを環境変数として設定します
3. 設定ファイルを指定してサーバーを実行します。

# Build the server
go build -o api_wrapper

# Run with your config
./api_wrapper my-apis.yaml

設定形式

設定ファイルでは、次の構造の YAML 形式を使用します。

# Server info
server:
  name: "API Gateway MCP"
  description: "Generic API gateway that wraps REST APIs as MCP tools"
  version: "1.0.0"
  
# Authentication
auth:
  token_env_var: "API_GATEWAY_TOKEN"  # Environment variable for the API token

# Tool definitions
tools:
  - name: "tool-name"
    description: "Tool description"
    endpoint: "https://api.example.com/endpoint"
    method: "POST"  # or "GET"
    timeout: 30  # in seconds
    template: |
      {
        "param1": "{{variable1}}",
        "param2": {{variable2}}
      }
    # For GET requests, use query_params
    query_params:
      param1: "{{variable1}}"
      param2: "{{variable2}}"
    parameters:
      variable1:
        type: "string"
        description: "Description of variable1"
        required: true
      variable2:
        type: "number"
        description: "Description of variable2"
        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"
      }
    }
  }
}

例

API 設定の例については、example-config.yaml をご覧ください。

環境変数

• auth.token_env_var フィールドで指定した環境変数を使用して、メインの認証トークンを設定します。
• {{env:VARIABLE_NAME}} 構文を使用して、テンプレート内でほかの環境変数を参照することもできます。