Mcp Hub Tool

MCP Hub Tools - HTTP MCP サーバーのドキュメント

これは、MCP Hub の HTTP ベースの MCP（Model Context Protocol）サーバーに関するドキュメントおよび設定リポジトリです。このサーバーでは、標準化された HTTP インターフェースを通じて MCP を検索、発見できます。

概要

MCP Hub は、Next.js アプリケーション内に Model Context Protocol (MCP) の HTTP エンドポイントを実装しており、AI アシスタントや開発ツールが MCP Hub の MCP を発見し、やり取りするための、最新で使いやすい方法を提供します。

プロトコルのサポート

⚠️ 重要な変更：このサーバーは HTTP ベースの MCP 接続のみをサポートします。従来の stdio ベースの実装は、より使いやすく信頼性の高い HTTP インターフェースに置き換えられ、非推奨となりました。

はじめに

mcp-hub-tools は、MCP Hub とやり取りするためのドキュメントと設定を提供します。このサーバーは、MCP を検索したり、登録済みの Model Context Protocol に関する詳細情報を取得したりするための、標準化された JSON-RPC 2.0 エンドポイントを提供します。

サーバーの実装場所：HTTP MCP サーバーは、実際には MCP Hub の Next.js アプリケーション内の /nextjs/app/api/open/mcp/route.ts に実装されています。

利用可能なツール

HTTP MCP サーバーは、JSON-RPC 2.0 を通じて以下のツールを提供します。

search_mcp

• 説明： キーワードを使って MCP Hub データベース内の MCP を検索します。一致した MCP の基本情報を一覧で返します。
• 入力スキーマ：

  {
    "type": "object",
    "properties": {
      "keywords": {
        "type": "string",
        "description": "Keywords to search for in MCP names, descriptions, and metadata"
      },
      "limit": {
        "type": "number",
        "description": "Maximum number of results to return (default: 50)",
        "default": 50
      }
    },
    "required": ["keywords"]
  }
  

• 出力： 以下を含む MCP の基本情報と検索結果を返します。
  • uuid：MCP の一意の識別子
  • name：MCP の名前
  • brief：簡単な説明
  • clicks：利用状況の統計
  • count：見つかった結果の合計数
  • keywords：使用した検索語

get_mcp_detail

• 説明： UUID を使って特定の MCP の詳細情報を取得します。
• 入力スキーマ：

  {
    "type": "object",
    "properties": {
      "mcp_id": {
        "type": "string",
        "description": "The UUID of the MCP to retrieve details for"
      }
    },
    "required": ["mcp_id"]
  }
  

• 出力： 以下を含む MCP の詳細情報を返します。
  • id：データベース内部の ID
  • uuid：一意の識別子
  • name：MCP の名前
  • brief：説明
  • website_url：公式ウェブサイト
  • author_name：作成者情報
  • created_at / updated_at：タイムスタンプ
  • is_recommended / is_official：ステータスフラグ
  • clicks：利用状況の統計
  • tags：関連するカテゴリー
  • metadata：追加情報
  • mcp_avatar_url / user_avatar_url：プロフィール画像

ツール応答の例

search_mcp の応答例

{
  "success": true,
  "data": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Blockchain MCP",
      "brief": "A Model Context Protocol for blockchain data analysis",
      "clicks": 142
    }
  ],
  "count": 1,
  "total_results": 1,
  "keywords": "blockchain"
}

get_mcp_detail の応答例

{
  "success": true,
  "data": {
    "id": 123,
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Blockchain MCP",
    "brief": "A comprehensive Model Context Protocol for blockchain data analysis",
    "website_url": "https://github.com/example/blockchain-mcp",
    "author_name": "Example Developer",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-03-20T14:45:00Z",
    "is_recommended": true,
    "is_official": false,
    "clicks": 142,
    "tags": ["blockchain", "crypto", "data-analysis"],
    "metadata": {
      "version": "1.2.0",
      "license": "MIT"
    },
    "mcp_avatar_url": "https://example.com/avatar.png",
    "user_avatar_url": "https://example.com/user.png"
  }
}

HTTP ベースの MCP サーバー

MCP Hub は、Next.js アプリケーション内に最新の HTTP ベースの MCP サーバー実装を提供しています。このサーバーは、従来の stdio ベースの方式と比べて、優れた信頼性と使いやすさを備えています。JSON-RPC 2.0 を HTTP 経由で使用して、Model Context Protocol を実装しています。

サーバーエンドポイント

本番環境の URL：https://www.aimcp.info/api/open/mcp

サポートされているトランスポート

• HTTP POST：標準の JSON-RPC 2.0 リクエスト
• Server-Sent Events (SSE)：クライアントとの統合を向上させるリアルタイムのストリーミング接続

主な機能

• ✅ JSON-RPC 2.0 準拠：MCP プロトコル仕様との完全な互換性
• ✅ 2 種類のトランスポートをサポート：クライアントのニーズに応じて HTTP POST と SSE を利用可能
• ✅ API キー認証：安全なアクセス制御
• ✅ レート制限：不正利用を防ぐ保護機能を標準搭載
• ✅ CORS サポート：クロスオリジンリクエストに対応
• ✅ エラー処理：包括的なエラーレスポンス

使い方

前提条件

• MCP Hub の API キー（https://www.aimcp.info）

API キーの取得方法

1. https://www.aimcp.info にアクセスします
2. アカウントを作成するか、ログインします
3. API Keys page に移動します
4. アプリケーション用の新しい API キーを生成します

注：API キーのレート制限は 1 時間あたり 20 リクエストです。

認証

HTTP MCP サーバーへのすべてのリクエストでは、Authorization ヘッダーに Bearer トークンを指定して認証する必要があります。

Authorization: Bearer YOUR_API_KEY

MCP クライアントの設定

HTTP ベースの設定（推奨）

最新の MCP クライアントは、HTTP サーバーに直接接続できます。

{
  "mcpServers": {
    "mcp-hub": {
      "url": "https://www.aimcp.info/api/open/mcp",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

簡易設定

簡易設定に対応するクライアントの場合：

{
  "mcpServers": {
    "mcp-hub": {
      "url": "https://www.aimcp.info/api/open/mcp",
      "apiKey": "YOUR_API_KEY"
    }
  }
}

Cursor IDE の設定

Cursor IDE の場合は、MCP の設定に追加します。

{
  "mcpServers": {
    "mcp-hub": {
      "url": "https://www.aimcp.info/api/open/mcp",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

接続のテスト

curl を使用して HTTP MCP サーバーをテストできます。

# Initialize connection
curl -X POST https://www.aimcp.info/api/open/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "initialize"}'

# List available tools
curl -X POST https://www.aimcp.info/api/open/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/list"}'

# Search for MCPs
curl -X POST https://www.aimcp.info/api/open/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "search_mcp", "arguments": {"keywords": "blockchain", "limit": 5}}}'

MCP プロトコルの実装

サポートされるメソッド

HTTP MCP サーバーは、以下の JSON-RPC 2.0 メソッドを実装しています。

• initialize：接続を確立し、サーバーの機能を取得します
• tools/list：利用可能なツールを取得します
• tools/call：引数を指定して特定のツールを実行します

レスポンス形式

すべてのレスポンスは JSON-RPC 2.0 仕様に準拠しています。

{
  "jsonrpc": "2.0",
  "id": "request_id",
  "result": {
    // Response data
  }
}

エラー処理

エラーは標準の JSON-RPC 2.0 形式で返されます。

{
  "jsonrpc": "2.0",
  "id": "request_id", 
  "error": {
    "code": -32603,
    "message": "Error description"
  }
}

サーバー情報

プロトコル仕様

• プロトコルバージョン：2024-11-05
• サーバー名：mcp-hub-search
• バージョン：1.0.0
• 機能：変更通知付きのツールが有効

レート制限

• API リクエスト：API キーごとに 1 時間あたり 20 リクエスト

CORS サポート

サーバーは、以下のヘッダーを使用したクロスオリジンリクエストをサポートしています。

• Access-Control-Allow-Origin: *
• Access-Control-Allow-Methods: GET, POST, OPTIONS
• Access-Control-Allow-Headers: Content-Type, Authorization, x-api-key

トラブルシューティング

よくある問題

1. 「有効なツールが 0 件」：MCP クライアントが initialize のレスポンスと capabilities.tools.listChanged フラグを適切に処理していることを確認してください。

2. 認証エラー：API キーが有効で、Authorization ヘッダーに含まれていることを確認してください。

3. 接続タイムアウト：https://www.aimcp.info の MCP Hub サーバーにアクセスできることを確認してください。

4. CORS エラー：クライアントが適切なヘッダーを含め、プリフライトの OPTIONS リクエストを処理していることを確認してください。

デバッグモード

デバッグでは、ブラウザーの開発者ツールや curl などのコマンドラインツールを使用して、生の HTTP リクエストとレスポンスを確認できます。

stdio ベースの実装からの移行

重要：stdio ベースの実装は非推奨になりました。移行するには：

1. MCP クライアントの設定を更新し、HTTP エンドポイントを使用します
2. コマンドベースの設定を URL ベースの設定に置き換えます
3. 認証方法を環境変数から HTTP ヘッダーに変更します
4. 提示された curl の例を使用して、新しい接続をテストします

サーバーアーキテクチャ

HTTP MCP サーバーは、MCP Hub の Next.js アプリケーションに統合されています。

• ソースコードの場所：/nextjs/app/api/open/mcp/route.ts
• 本番サービス：https://www.aimcp.info/api/open/mcp

コントリビューション

この HTTP MCP サーバーは、MCP Hub プロジェクトの一部です。問題の報告やコントリビューションについては、メインリポジトリをご覧ください。

ライセンス

MIT ライセンス

関連リンク

• MCP Hub のウェブサイト
• Model Context Protocol の仕様
• API ドキュメント