Dune Analytics MCP Server

Dune Analytics MCP サーバー

Dune Analytics のデータを AI エージェントに連携する MCP サーバーです。

機能

• ツール：
  • get_latest_result：Dune クエリの ID を指定して、最新の結果を取得します。
  • run_query：Dune クエリの ID を指定して実行し、結果を取得します。
• CSV 出力：すべての結果は、処理しやすい CSV 形式の文字列として返されます。

前提条件

• Python 3.10+
• 有効な Dune Analytics API キー（Dune Analytics から取得できます）

インストール

Smithery 経由でのインストール

Smithery 経由で、Claude Desktop 用の Dune Analytics を自動的にインストールするには：

npx -y @smithery/cli install @kukapay/dune-analytics-mcp --client claude

手動インストール

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 でのコマンド例

• 「Dune クエリ 1215383 の最新の結果を取得して」
• 「Dune クエリ 1215383 を実行して」

ライセンス

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