Api Wrapper MCP

🚀 API 包装器 MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）用の汎用 API 包装器サーバーです。REST API を MCP ツールに簡単にラップでき、Claude やその他の MCP クライアントからアクセスできるようになります。

✨ 主な機能

• YAML 設定ファイルを使用して、複数の API エンドポイントを簡単に設定できます。
• GET および POST リクエストをサポートします。
• パラメータの検証とデフォルト値を提供します。
• 環境変数を使用した認証が可能です。
• API 呼び出しのタイムアウト時間をカスタマイズできます。

📦 インストール

1. API エンドポイントを定義する YAML 設定ファイルを作成します（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"
      }
    }
  }
}

サンプル

API 設定のサンプルについては、example-config.yaml を参照してください。

環境変数

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