デューンクエリMCP

バージョンパイソン

モデル制御プロトコル (MCP) を介して Dune Analytics データをインテリジェントエージェントに接続する最新のブリッジ。

概要

dune-query-mcpは、ブロックチェーンデータ分析をAIアプリケーションにシームレスに統合することを可能にします。Dune Analyticsの強力なクエリ機能とモデル制御プロトコルを活用することで、LLMやその他のAIシステムは、シンプルな自然言語によるインタラクションを通じてオンチェーンデータにアクセスできるようになります。

Related MCP server: Bankless Onchain MCP Server

コア機能

データ取得ツール

道具	説明	使用事例
`get_latest_result`	事前に計算されたクエリ結果を取得します	既存データへのクイックアクセス
`run_query`	オンデマンドでクエリを実行する	リアルタイムデータ分析

データ形式

すべてのデータは CSV 形式で返され、次の情報が提供されます。

ユニバーサルな互換性
ほとんどのデータ分析ツールで簡単に解析可能
人間が読める出力

はじめる

システム要件

Python 3.10以上
有効な Dune Analytics API キー (こちらから取得してください)

クイックセットアップ

クローンとナビゲート

git clone https://github.com/olaxbt/dune-query-mcp-mcp.git
cd dune-query-mcp

環境設定

# Create virtual environment
python -m venv .venv

# Activate it
source .venv/bin/activate  # Linux/Mac
# or
.venv\Scripts\activate     # Windows

# Install dependencies
pip install -r requirements.txt

APIアクセスを構成する

# Copy example config
cp .env.example .env

# Edit with your API key
echo "DUNE_API_KEY=your_key_here" > .env

使用法

サービスの実行

dune-query-mcp には、次の 2 つの実行方法があります。

MCPサービスとして

python run.py

これにより、デフォルトのポート 8000 で MCP サービスが開始されます。

Webサーバーとして

python flask_app.py

これにより、Web インターフェースと REST API エンドポイントへのアクセスが提供されます。

アプリケーションとの統合

MCPクライアント統合

from mcp.client import Client

# Connect to Dune-query-mcp
client = Client("http://localhost:8000")

# Get latest results for a query
csv_data = client.call("get_latest_result", query_id=1234567)

# Execute a query
query_results = client.call("run_query", query_id=1234567)

REST API

終点	方法	説明
`/dune/health`	得る	サービスヘルスチェック
`/dune/query/{query_id}/latest`	得る	最新の結果を取得
`/dune/query/{query_id}/execute`	役職	クエリを実行する

REST呼び出しの例:

curl -X GET http://localhost:5000/dune/query/1234567/latest

建築

dune-query-mcp/
├── app/                       # Application core
│   ├── __init__.py            # Flask & MCP setup
│   ├── routes/                # API endpoint definitions
│   │   └── dune_routes/       # Dune Analytics routes
│   │   └── templates/             # Web interface
│   └── templates/             # Web interface
├── config/                    # Configuration files
├── logs/                      # Runtime logs
├── flask_app.py               # Web server entry point
├── run.py                     # MCP server entry point
└── requirements.txt           # Dependencies

詳細設定

環境変数

変数	目的	デフォルト
DUNE_API_KEY	Dune API の認証	なし（必須）
ポート	サーバーポート	8000

パフォーマンスチューニング

大量のクエリ実行の場合:

# Set a higher timeout for long-running queries
export DUNE_QUERY_TIMEOUT=600  # 10 minutes in seconds

トラブルシューティング

よくある問題と解決策:

問題	解決
APIキーエラー	有効なキーを持つ`.env`ファイルが存在することを確認する
タイムアウトエラー	複雑なクエリのタイムアウトを増やす
CSV解析の問題	クエリが適切な表形式データを返すかどうかを確認します

貢献

貢献を歓迎します！以下の手順に従ってください。

リポジトリをフォークする
機能ブランチを作成する: git checkout -b feature/amazing-feature
変更をコミットします: git commit -am 'Add some amazing feature'
ブランチにプッシュ: git push origin feature/amazing-feature
プルリクエストを開く

ライセンス

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

謝辞

FastMCPで構築
Dune Analyticsによるクエリ機能

Dune Query MCP