Any OpenAPI MCP サーバー

“Any OpenAPI” MCP サーバーは何をするのか？

「Any OpenAPI」MCP サーバーは、Claude などの AI アシスタントを OpenAPI（Swagger）仕様を公開しているあらゆる外部 API に接続するためのツールです。大規模な OpenAPI ドキュメント上でのセマンティック検索を可能にし、エンドポイントをインテリジェントに分割して高速に発見・操作できます。AI クライアントは自然言語クエリ（例：「商品を一覧表示」）で関連する API エンドポイントを発見し、即座に完全なエンドポイントドキュメントを取得し、サーバーから直接 API リクエストを実行できます。このサーバーは、プライベートまたは大規模 API を AI 主導のワークフローに統合するのに最適で、データベースクエリやカスタム API 統合を頻繁な手動更新なしで効率化します。

プロンプト一覧

利用可能なドキュメントやコード内に特定のプロンプトテンプレートは記載されていません。

リソース一覧

利用可能なドキュメントやコード内に明示的な MCP リソースの記載はありません。

ツール一覧

• custom_api_request_schema
  OpenAPI 仕様に対してセマンティック検索を行い、自然言語クエリに基づいた関連 API エンドポイントのドキュメントチャンクを発見します。
• custom_make_request
  選択したエンドポイントに対して API リクエストを実行します。AI アシスタントが API と直接やりとりし、リクエスト送信やレスポンス取得を可能にします。

この MCP サーバーの活用例

• プライベートサービス向け API 統合
  OpenAPI JSON URL を指定することで、Claude や他アシスタントをプライベート API にシームレスに接続し、内部システムとの安全かつ動的な連携が可能です。
• 迅速なエンドポイント発見
  FAISS と MiniLM-L3 によるメモリ内セマンティック検索で、大規模かつ複雑な OpenAPI ドキュメントから関連エンドポイントを高速発見します。
• API リクエストの自動実行
  AI クライアントがエンドポイント発見だけでなく、API リクエストも実行できるため、商品リストや注文管理、ユーザー検索などのワークフローを追加ツールなしで自動化できます。
• コンテキストに応じた API ドキュメント取得
  エンドポイント固有のドキュメントを即座に取得でき、AI 主導の自動化に必要な詳細パラメータの発見と活用を支援します。
• Claude Desktop などのクライアントとの統合
  Claude の MCP クライアントと連携する設計で、ドキュメントサイズ制限を克服し、デスクトップ AI アプリ向けに大規模 API の実用的活用を可能にします。

セットアップ方法

Windsurf

1. Node.js と Windsurf がインストール済みであることを確認してください。
2. Windsurf の設定ファイルを探します。
3. @any-openapi/mcp-server@latest を mcpServers オブジェクトに追加します。
4. コマンドや必要な環境変数（例: OPENAPI_JSON_DOCS_URL）を設定します。
5. 保存して Windsurf を再起動し、サーバーが期待通り表示されることを確認します。

例：JSON

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

API キーの安全な管理：

{
  "env": {
    "API_KEY": "${ANY_OPENAPI_API_KEY}"
  },
  "inputs": {
    "apiKey": "${ANY_OPENAPI_API_KEY}"
  }
}

Claude

1. Claude が MCP サーバー統合をサポートしていることを確認してください。
2. MCP サーバー用の設定や設定パネルを開きます。
3. コマンドや環境変数を含めたサーバー詳細を挿入します。
4. 変更を保存し、必要に応じて Claude を再起動します。
5. サーバーが認識されていることを確認します。

例：JSON

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

Cursor

1. Cursor をインストールし、MCP サーバー設定セクションへ移動します。
2. @any-openapi/mcp-server@latest パッケージを使って新しい MCP サーバーエントリを追加します。
3. 必要に応じて API の環境変数を設定します。
4. 設定を保存して Cursor を再起動します。
5. 利用可能なツールをリストして統合を確認します。

例：JSON

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

Cline

1. Cline の設定ファイルを開きます。
2. @any-openapi/mcp-server@latest 用の MCP サーバー設定を追加します。
3. 必要な環境変数を設定します。
4. 保存して Cline を再起動します。
5. サーバーが有効な MCP サーバー一覧に表示されていることを確認します。

例：JSON

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

API キーの安全な管理：
上記のように環境変数を利用して、機密情報を露出しないようにしてください。

フロー内での MCP 利用方法

FlowHunt での MCP 利用例

FlowHunt のワークフローに MCP サーバーを統合するには、まず MCP コンポーネントをフローに追加し、AI エージェントと接続します。

MCP コンポーネントをクリックして設定パネルを開きます。システム MCP 設定セクションで、次の JSON 形式で MCP サーバー情報を入力してください：

{
  "any-openapi": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定後、AI エージェントはこの MCP をツールとして利用でき、全機能にアクセス可能になります。 “any-openapi” を実際の MCP サーバー名に、URL も正しいエンドポイントに置き換えてください。

概要

Roots サポート: 利用可能なドキュメントやコードでの言及なし。

提供されたドキュメントと上記のまとめから、この MCP サーバーは API 統合と動的エンドポイント発見に特化し、機能的で実用的ですが、明示的なサンプルプロンプトやリソース、サンプリングや roots の記載はありません。セットアップやセキュリティの手法は明確で標準的です。

私たちの評価

この MCP サーバーは、特に Claude との連携を前提とした大規模・プライベート API の AI アシスタント統合に非常に実用的です。セマンティックなエンドポイント発見や直接的な API 実行の実用性が高い一方、さらなるドキュメントやリソース定義があればより良いでしょう。全体として堅実で実用本位ですが、MCP の全機能を網羅する完全例ではありません。

評価：7/10

MCP スコア