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ファイルを参照してください。