-
securityA
license-
qualityA mcp server that bridges Dune Analytics data to AI agents.
Last updated -
28
MIT License
デューンクエリMCP
モデル制御プロトコル (MCP) を介して Dune Analytics データをインテリジェント エージェントに接続する最新のブリッジ。
概要
dune-query-mcpは、ブロックチェーンデータ分析をAIアプリケーションにシームレスに統合することを可能にします。Dune Analyticsの強力なクエリ機能とモデル制御プロトコルを活用することで、LLMやその他のAIシステムは、シンプルな自然言語によるインタラクションを通じてオンチェーンデータにアクセスできるようになります。
コア機能
データ取得ツール
道具 | 説明 | 使用事例 |
| 事前に計算されたクエリ結果を取得します | 既存データへのクイックアクセス |
| オンデマンドでクエリを実行する | リアルタイムデータ分析 |
データ形式
すべてのデータは 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サービスとして
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
終点 | 方法 | 説明 |
| 得る | サービスヘルスチェック |
| 得る | 最新の結果を取得 |
| 役職 | クエリを実行する |
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キーエラー | 有効なキーを持つ
ファイルが存在することを確認する |
タイムアウトエラー | 複雑なクエリのタイムアウトを増やす |
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によるクエリ機能
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
モデル制御プロトコルを介して Dune Analytics ブロックチェーン データを AI アプリケーションに接続するブリッジ。これにより、LLM は自然言語による対話を通じてオンチェーン データにアクセスできるようになります。
Related MCP Servers
- AsecurityFlicenseAqualityImplements the Model Context Protocol to allow AI models to access and interact with blockchain data, including reading contract states, retrieving events, and accessing transaction information across various networks.Last updated -102267
Nodit MCP Serverofficial
AsecurityAlicenseAqualityConnects AI agents and developers to structured blockchain data across multiple networks through Nodit's Web3 infrastructure, enabling easy querying, analysis and interaction with blockchain ecosystems without specialized development expertise.Last updated -92318Apache 2.0- -securityAlicense-qualityA Model Context Protocol server that connects AI agents to Dune Analytics data, providing access to DEX metrics, EigenLayer statistics, and Solana token balances through structured tools.Last updated -2MIT License