デューンクエリMCP
モデル制御プロトコル (MCP) を介して Dune Analytics データをインテリジェント エージェントに接続する最新のブリッジ。
概要
dune-query-mcpは、ブロックチェーンデータ分析をAIアプリケーションにシームレスに統合することを可能にします。Dune Analyticsの強力なクエリ機能とモデル制御プロトコルを活用することで、LLMやその他のAIシステムは、シンプルな自然言語によるインタラクションを通じてオンチェーンデータにアクセスできるようになります。
Related MCP server: Bankless Onchain MCP Server
コア機能
データ取得ツール
道具 | 説明 | 使用事例 |
| 事前に計算されたクエリ結果を取得します | 既存データへのクイックアクセス |
| オンデマンドでクエリを実行する | リアルタイムデータ分析 |
データ形式
すべてのデータは 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.txtAPIアクセスを構成する
# 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サービスとして
これにより、デフォルトのポート 8000 で MCP サービスが開始されます。
Webサーバーとして
これにより、Web インターフェースと REST API エンドポイントへのアクセスが提供されます。
アプリケーションとの統合
MCPクライアント統合
REST API
終点 | 方法 | 説明 |
| 得る | サービスヘルスチェック |
| 得る | 最新の結果を取得 |
| 役職 | クエリを実行する |
REST呼び出しの例:
建築
詳細設定
環境変数
変数 | 目的 | デフォルト |
DUNE_API_KEY | Dune API の認証 | なし（必須） |
ポート | サーバーポート | 8000 |
パフォーマンスチューニング
大量のクエリ実行の場合:
トラブルシューティング
よくある問題と解決策:
問題 | 解決 |
APIキーエラー | 有効なキーを持つ
ファイルが存在することを確認する |
タイムアウトエラー | 複雑なクエリのタイムアウトを増やす |
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によるクエリ機能