任意のREST APIをMCPサーバーに変換する方法

REST APIをMCPに変換する理由

モデルコンテキストプロトコル（MCP）は、Claude、ChatGPT、CopilotのようなAIアシスタントが外部ツールと対話するための標準です。REST APIをMCPサーバーに変換することで、AIエージェントが自然言語を使用してエンドポイントを呼び出すことができるようになります — カスタムコードは不要です。

必要なもの

• REST API（HTTPエンドポイントを持つ任意のAPI）
• マシンにインストールされたDocker
• MCP互換のAIクライアント（Claude Desktop、Claude.ai、ChatGPT、Copilot、Cursorなど）

ステップバイステップ: REST APIを変換する

ステップ 1: AnythingMCPをデプロイする

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

これにより、バックエンド（ポート4000）、ダッシュボード（ポート3000）、およびPostgreSQLが起動します。

ステップ 2: RESTコネクタを作成する

http://localhost:3000でダッシュボードを開き、新しいRESTコネクタを作成します。次の方法でAPIをインポートできます：

• OpenAPI/Swagger仕様 — URLを貼り付けるか、JSON/YAMLファイルをアップロード
• Postmanコレクション — Postmanのエクスポートを直接インポート
• cURLコマンド — cURLコマンドを貼り付け、AnythingMCPがそれをエンドポイントに解析

ステップ 3: 認証を設定する

コネクタ設定でAPIの認証方法を設定します：

• ベアラートークン
• APIキー（ヘッダーまたはクエリ）
• ベーシック認証
• OAuth 2.0

環境変数を使用して秘密情報を管理し、設定ファイルから除外できます。

ステップ 4: 自動生成されたMCPツールを確認する

AnythingMCPは各RESTエンドポイントをMCPツールに自動的に変換します。ダッシュボードでツールを確認し、名前や説明をカスタマイズし、公開したくないエンドポイントを非表示にします。

ステップ 5: AIアシスタントに接続する

MCPサーバーをAIクライアントの設定に追加します：

{
  "mcpServers": {
    "my-api": {
      "url": "http://localhost:4000/mcp"
    }
  }
}

これで、AIアシスタントは自然言語を通じてREST APIエンドポイントを呼び出すことができます。

すべての主要なAIツールと連携

• Claude Desktop / Claude.ai — 完全なMCPサポート
• ChatGPT — MCPプラグイン経由
• Microsoft Copilot — MCP統合
• Cursor — 組み込みのMCPサポート
• Windsurf — ネイティブMCPサポート

ベストプラクティス

1. 読み取り専用から開始 — 最初にGETエンドポイントを公開し、その後書き込み操作を追加
2. 意味のある名前を使用 — ダッシュボードでツールの名前を明確に変更
3. 説明を追加 — AIエージェントが各ツールの機能を理解できるようにする
4. レート制限を設定 — 過剰な呼び出しからAPIを保護

次のステップ

• SOAPをMCPに変換する — レガシーSOAPサービス向け
• GraphQLをMCPに変換する — GraphQL API向け
• データベースをMCPに接続する — 直接DBアクセス向け