“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
- Node.js と Windsurf がインストール済みであることを確認してください。
- Windsurf の設定ファイルを探します。
@any-openapi/mcp-server@latestをmcpServersオブジェクトに追加します。- コマンドや必要な環境変数(例:
OPENAPI_JSON_DOCS_URL)を設定します。 - 保存して 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
- Claude が MCP サーバー統合をサポートしていることを確認してください。
- MCP サーバー用の設定や設定パネルを開きます。
- コマンドや環境変数を含めたサーバー詳細を挿入します。
- 変更を保存し、必要に応じて Claude を再起動します。
- サーバーが認識されていることを確認します。
例:JSON
{
"mcpServers": {
"any-openapi": {
"command": "npx",
"args": ["@any-openapi/mcp-server@latest"],
"env": {
"OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
}
}
}
}
Cursor
- Cursor をインストールし、MCP サーバー設定セクションへ移動します。
@any-openapi/mcp-server@latestパッケージを使って新しい MCP サーバーエントリを追加します。- 必要に応じて API の環境変数を設定します。
- 設定を保存して Cursor を再起動します。
- 利用可能なツールをリストして統合を確認します。
例:JSON
{
"mcpServers": {
"any-openapi": {
"command": "npx",
"args": ["@any-openapi/mcp-server@latest"],
"env": {
"OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
}
}
}
}
Cline
- Cline の設定ファイルを開きます。
@any-openapi/mcp-server@latest用の MCP サーバー設定を追加します。- 必要な環境変数を設定します。
- 保存して Cline を再起動します。
- サーバーが有効な 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 も正しいエンドポイントに置き換えてください。
概要
| セクション | 利用可否 | 詳細・備考 |
|---|---|---|
| Overview(概要) | ✅ | |
| List of Prompts(プロンプト一覧) | ⛔ | 記載なし |
| List of Resources(リソース一覧) | ⛔ | 記載なし |
| List of Tools(ツール一覧) | ✅ | 発見・実行の2ツール |
| Securing API Keys(API キーの安全な管理) | ✅ | 環境変数経由 |
| Sampling Support(サンプリングサポート) | ⛔ | 記載なし(評価上重要度低) |
Roots サポート: 利用可能なドキュメントやコードでの言及なし。
提供されたドキュメントと上記のまとめから、この MCP サーバーは API 統合と動的エンドポイント発見に特化し、機能的で実用的ですが、明示的なサンプルプロンプトやリソース、サンプリングや roots の記載はありません。セットアップやセキュリティの手法は明確で標準的です。
私たちの評価
この MCP サーバーは、特に Claude との連携を前提とした大規模・プライベート API の AI アシスタント統合に非常に実用的です。セマンティックなエンドポイント発見や直接的な API 実行の実用性が高い一方、さらなるドキュメントやリソース定義があればより良いでしょう。全体として堅実で実用本位ですが、MCP の全機能を網羅する完全例ではありません。
評価:7/10
MCP スコア
| ライセンスあり | ✅ (MIT) |
|---|---|
| ツールが1つ以上ある | ✅ |
| フォーク数 | 12 |
| スター数 | 52 |
