Dune Analytics MCP Server

Dune Analytics MCP サーバー

Dune Analytics のデータを AI エージェントに橋渡しする Model Context Protocol（MCP）サーバーです。DEX 指標、EigenLayer のオペレーターと AVS の統計情報、Solana 上のトークン残高にアクセスできます。ツールでは、Dune が提供するプリセットエンドポイントとエコーエンドポイントを利用します。

機能

• ツール：
  • get_dex_pair_metrics：特定のチェーン上にある指定したトークンペアの基本的なメタデータと統計データを取得します
  • get_token_pairs_liquidity：指定したチェーン上で、USD 流動性が最も高いトークンペアを検索します
  • get_svm_token_balances：Solana 上の指定したウォレットアドレスのトークン残高を取得します
  • get_eigenlayer_avs_metrics：指定した AVS の統計情報を取得します
  • get_eigenlayer_operator_metrics：指定した AVS のすべてのオペレーターの統計情報を取得します
• データ形式：すべての結果は、簡単に処理できる構造化 JSON 形式で返されます

前提条件

• Node.js 16+ または Bun 1.0+
• 有効な Dune Analytics API キー（Dune Analytics から取得できます）

インストール

1. リポジトリをクローンする：

   git clone https://github.com/ekailabs/dune-mcp-server.git
   cd dune-mcp-server
   

2. 依存関係をインストールする： Bun を使用する場合：

   bun install
   

   または npm を使用する場合：

   npm install
   

3. 環境変数を設定する： プロジェクトのルートに .env ファイルを作成し、.env.example を参考に設定します：

   DUNE_API_KEY=your_api_key_here
   

   または、システム環境変数として設定します：

   export DUNE_API_KEY="your_api_key_here"
   

使い方

サーバーの実行

Bun を使用する場合：

# Development mode with hot reload
bun dev

# Production mode
bun start

# Or build and run
bun build src/index.ts --outdir dist
bun dist/index.js

npm を使用する場合：

# Development mode with hot reload
npm run dev

# Production mode
npm start

# Or build and run
npm run build
npm run start:prod

Claude for Desktop に追加する

Claude for Desktop で使用するには、サーバーの設定を追加します：

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dune": {
      "command": "bun",
      "args": [
        "/ABSOLUTE/PATH/TO/dune-mcp-server/src/index.ts",
        "stdio"
      ]
    }
  }
}

ツールの使用方法

1. get_dex_pair_metrics(chain, token_pair)

   • 説明：指定したトークンペアの基本的なメタデータと統計データを取得します
   • 入力：
     • chain (string) - DEX の統計情報を取得するブロックチェーン
     • token_pair (string) - DEX の統計情報を取得するトークンペア
   • 出力：DEX 指標を含む JSON オブジェクト

2. get_token_pairs_liquidity(chain)

   • 説明：指定したチェーン上で、USD 流動性が最も高いトークンペアを特定します
   • 入力：chain (string) - DEX の統計情報を取得するブロックチェーン
   • 出力：上位トークンペアの指標を含む JSON オブジェクト

3. get_svm_token_balances(wallet_address)

   • 説明：Solana ブロックチェーン上にある指定したウォレットアドレスの残高を取得します
   • 入力：wallet_address (string) - 残高を取得するウォレットのアドレス
   • 出力：トークン残高を含む JSON 配列

4. get_eigenlayer_avs_metrics(avs_name)

   • 説明：指定した AVS の統計情報を取得します
   • 入力：avs_name (string) - 統計情報を取得する AVS の名前
   • 出力：AVS 指標を含む JSON オブジェクト

5. get_eigenlayer_operator_metrics(avs_name)

   • 説明：指定した AVS のすべてのオペレーターの統計情報を取得します
   • 入力：avs_name (string) - オペレーターの統計情報を取得する AVS の名前
   • 出力：オペレーターの指標を含む JSON オブジェクト

Claude for Desktop でのコマンド例

• 「ethereum 上の『USDC-WETH』トークンペアの流動性を教えてください」
• 「arbitrum 上で流動性が最も高いトークンペアを表示してください」
• 「EigenDA オペレーターのステーク分布をグラフにしてもらえますか？」
• 「EigenDA AVS にはステーカーが何人いますか？」

ライセンス

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

evals の実行

evals パッケージは mcp クライアントを読み込み、そのクライアントが index.ts ファイルを実行するため、テストのたびに再ビルドする必要はありません。npx コマンドの前に環境変数を指定して読み込めます。詳しいドキュメントはこちらをご覧ください。

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

謝辞

• API を提供する Dune Analytics に感謝します
• プロトコル仕様を提供する Model Context Protocol に感謝します