Dune Analytics MCP

🚀 Dune Analytics MCP 服務器

Dune Analytics MCP 服務器是一款強大的工具，它能夠將 Dune Analytics 中的數據無縫橋接到 AI 代理，為數據處理和分析帶來極大便利。

✨ 主要特性

• 實用工具：
  • get_latest_result：可輕鬆獲取指定 Dune 查詢 ID 的最新結果。
  • run_query：執行指定 Dune 查詢 ID 並獲取相應結果。
• 便捷輸出：所有結果均以 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 上使用。

工具使用方法

基礎用法

• get_latest_result(query_id)
  • 描述：獲取指定 Dune 查詢的最新結果。
  • 輸入：query_id（整數）- Dune 查詢的 ID。
  • 輸出：CSV 格式字符串，包含查詢結果。
  • 示例：

    get_latest_result(query_id=4853921)
    

高級用法

• run_query(query_id)
  • 描述：執行指定 Dune 查詢並返回結果。
  • 輸入：query_id（整數）- 要運行的 Dune 查詢 ID。
  • 輸出：CSV 格式字符串，包含查詢結果。
  • 示例：

    run_query(query_id=1215383)
    

Claude Desktop 示例命令

• “獲取 Dune 查詢 1215383 的最新結果”
• “運行 Dune 查詢 1215383”

📄 許可證

該項目使用 MIT 許可證，有關詳細信息，請參閱LICENSE文件。