TheGraph MCP Server

TheGraph MCP サーバー

The Graph のインデックス済みブロックチェーンデータを AI エージェントに提供する MCP サーバーです。

利用可能なツール

1. getSubgraphSchema

指定したサブグラフのスキーマを取得し、AI エージェントが GraphQL クエリを生成するために必要なコンテキストを提供します。

パラメーター：

• subgraphId：サブグラフ ID（例：「QmZBQcF...」）
• asText：出力形式のフラグ
  • true：人が読みやすい GraphQL スキーマを返します
  • false：JSON スキーマを返します（デフォルト）

2. querySubgraph

指定したサブグラフに対して GraphQL クエリを実行します。通常は AI がクエリを生成しますが、手動で作成することもできます。

パラメーター：

• subgraphId：サブグラフ ID
• query：GraphQL クエリ文字列

インストール

1. リポジトリをクローン

   git clone https://github.com/kukapay/thegraph-mcp.git
   

2. クライアントの設定

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

プロンプトの例

ツールを起動する自然言語のプロンプトの例を紹介します。

スキーマに関するクエリ

• 「サブグラフ QmZBQcF... のスキーマを読みやすい形式で表示してください」
• 「QmZBQcF... サブグラフの構造はどうなっていますか？ GraphQL 形式で表示してください」
• 「サブグラフ QmZBQcF... のデータモデルを理解したいので、スキーマを取得してください」

データに関するクエリ

• 「サブグラフ QmZBQcF... から、過去 24 時間の取引高上位 5 件のトークンを検索してください」
• 「サブグラフ QmZBQcF... で、流動性が 100 万 USD を超えるすべてのペアを表示してください」
• 「QmZBQcF... サブグラフから最新のスワップイベントを 10 件取得し、トークンのシンボルと数量も含めてください」

分析タスク

• 「サブグラフ QmZBQcF... を使って、過去 1 週間の USDT ペアの取引高を分析してください」
• 「サブグラフ QmZBQcF... で、ETH ペアと USDC ペアの流動性を比較してください」
• 「QmZBQcF... から、過去 24 時間の異常な取引パターンを見つけてください」

複合タスク

• 「まず QmZBQcF... のスキーマを取得し、高額取引を検索するクエリの作成を手伝ってください」
• 「QmZBQcF... のスキーマを確認し、トークン価格の検索に利用できるフィールドを教えてください」
• 「サブグラフ QmZBQcF... を使い、まずスキーマを確認してから関連イベントをクエリし、大口取引の市場への影響を分析してください」

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。