Dune Analytics MCP サーバー

Dune Analytics データを AI エージェントに橋渡しする MCP サーバー。

特徴

• ツール:
  • get_latest_result : ID で Dune クエリの最新の結果を取得します。
  • run_query : ID で Dune クエリを実行し、結果を取得します。
• CSV 出力: すべての結果は、簡単に処理できるように CSV 形式の文字列として返されます。

前提条件

• Python 3.10以上
• 有効な Dune Analytics API キー ( Dune Analyticsから取得)

インストール

1. リポジトリのクローンを作成します:
   git clone https://github.com/kukapay/dune-analytics-mcp.git cd dune-analytics-mcp
2. 環境変数の設定: プロジェクト ルートに.envファイルを作成します。
   DUNE_API_KEY=your_api_key_here
   あるいは、システム環境変数として設定します。
   export DUNE_API_KEY="your_api_key_here"

使用法

サーバーの実行

• 開発モード:
  mcp dev main.py
  これにより、開発用にホット リロードでサーバーが起動します。
• Claude Desktop のインストール:
  mcp install main.py --name "Dune Analytics"
  Claude Desktop で使用するためにサーバーをサービスとしてインストールします。

ツールの使用

1. get_latest_result(query_id)
   • 説明: 指定された Dune クエリの最新の結果を取得します。
   • 入力: query_id (int) - Dune クエリの ID。
   • 出力: クエリ結果の CSV 形式の文字列。
   • 例：
     get_latest_result(query_id=4853921)
2. run_query(query_id)
   • 説明: Dune クエリを実行し、結果を返します。
   • 入力: query_id (int) - 実行する Dune クエリの ID。
   • 出力: クエリ結果の CSV 形式の文字列。
   • 例：
     run_query(query_id=1215383)

Claude Desktopのコマンド例

• 「砂丘クエリ1215383の最新結果を取得」
• 「デューンクエリ1215383を実行」

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。