「TheGraph」MCPサーバーは何をするのか？

TheGraph MCPサーバーは、AIエージェントをThe Graphプロトコルのインデックス化されたブロックチェーンデータと接続するための統合レイヤーです。標準化されたMCP（Model Context Protocol）ツールを介してサブグラフデータを公開し、AIシステムが効率的にブロックチェーン情報へアクセス、クエリ、分析できるようにします。アシスタントがサブグラフスキーマの取得やGraphQLクエリの実行を行えるため、TheGraph MCPサーバーはブロックチェーン分析、オンチェーンデータの取得、分散型金融（DeFi）モニタリングを含む開発ワークフローを支援します。これにより、開発者やAIエージェントは構造化されたブロックチェーンデータの取得、自動分析、The Graphの分散インデックスネットワークとシームレスに連携するアプリケーションの構築が可能となります。

プロンプト一覧

• スキーマクエリ
  • 指定サブグラフのスキーマ取得や、読みやすいGraphQLスキーマのリクエスト、データモデル構造の把握などのプロンプト。
• データクエリ
  • サブグラフから特定データを取得するプロンプト。例：取引量上位トークンの検索、高流動性ペアの取得、最近のスワップイベントのリスト表示など。
• 分析タスク
  • 特定トークンの一定期間における取引量分析など、ブロックチェーンデータに対する分析プロンプト。

リソース一覧

このリポジトリには明示的なMCPリソースは記載されていません。

ツール一覧

• getSubgraphSchema
  • 指定サブグラフのスキーマを取得し、AIエージェントがThe Graphでインデックス化されたブロックチェーンデータの構造や形式を把握できるようにします。
• querySubgraph
  • 指定サブグラフに対してGraphQLクエリを実行し、The Graphのインデックス化ブロックチェーンデータからカスタムデータセットや分析結果を直接取得します。

このMCPサーバーのユースケース

• ブロックチェーンデータ分析
  • 開発者やAIエージェントがオンチェーンデータ（取引量や流動性など）を分析し、DeFiプラットフォームやトレーディングボット向けのインサイトを提供。
• 開発者向けスキーマ探索
  • サブグラフスキーマを迅速に取得してデータモデルを理解し、ブロックチェーン統合アプリの開発スピードを向上。
• DeFiモニタリングとレポーティング
  • サブグラフクエリを活用し、分散型取引所や資産の主要指標（例：上位トークン、スワップイベントなど）を自動で監視・レポート。
• カスタムデータ取得
  • カスタムGraphQLクエリの作成・実行により、リサーチ、ダッシュボード、リアルタイム分析向けに特定のブロックチェーンデータを抽出。
• AIによるブロックチェーンアシスタント
  • ブロックチェーンデータに基づく質問応答やタスク自動化（異常取引のアラートやレポート生成など）を行うエージェントに活用。

セットアップ方法

Windsurf

1. 必須条件: Python 3.10+ およびuvがインストールされていることを確認してください。
2. リポジトリをクローン:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. 設定ファイルを編集: Windsurfの設定（例:config.json）を探します。
4. TheGraph MCPサーバーを追加:

   {
     "mcpServers": {
       "thegraph-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

5. 保存してWindsurfを再起動。
6. 検証: スキーマまたはデータクエリのプロンプトでテスト。

Claude

1. 必須条件: Pythonおよびuvがインストールされていること。
2. リポジトリをクローン:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. ClaudeのMCP設定を更新: Claudeの設定ファイルを編集。
4. サーバー詳細を挿入:

   {
     "mcpServers": {
       "thegraph-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

5. Claudeを再起動し、接続テスト。

Cursor

1. 必須条件をインストール: Python 3.10+ およびuv。
2. リポジトリをクローン:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. CursorのMCP設定ファイルを編集。
4. 以下のJSONを追加:

   {
     "mcpServers": {
       "thegraph-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

5. Cursorを再起動し、テストクエリで確認。

Cline

1. 必須条件: Python 3.10+ およびuvが利用可能であることを確認。
2. リポジトリをクローン:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Clineの設定ファイルを編集。
4. MCP設定に以下を挿入:

   {
     "mcpServers": {
       "thegraph-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

5. Clineを再起動し、プロンプトで動作確認。

APIキーの安全な管理

• THEGRAPH_API_KEYは環境変数として保存してください。
• 設定例:

  {
    "mcpServers": {
      "thegraph-mcp": {
        "command": "uv",
        "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
        "env": {
          "THEGRAPH_API_KEY": "${THEGRAPH_API_KEY}"
        }
      }
    }
  }
  

FlowHuntフロー内でのMCP利用方法

FlowHuntでのMCP利用

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

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

{
  "thegraph-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定が完了すると、AIエージェントはこのMCPをツールとして利用できるようになり、すべての機能にアクセス可能となります。“thegraph-mcp"はお使いのMCPサーバー名に、URLも実際のMCPサーバーURLに必ず置き換えてください。

概要

総評

TheGraph MCPサーバーは、The Graphのインデックス化ブロックチェーンデータと対話するための明快なインターフェースと2つの基本ツールを提供しています。セットアップやセキュリティも記載されていますが、明示的なMCPリソースやroots、サンプリングの詳細は不足しています。用途には十分で、シンプルかつ実用的です。

評価: 7/10

MCPスコア