Dune分析数据桥接服务

一个将Dune Analytics数据桥接到AI代理的服务器,提供查询执行和结果获取功能,适用于数据分析和AI代理集成场景。

  • by kukapay
  • Python
  • 本地部署
  • 41 星标
  • 更新于
在 GitHub 查看 kukapay/dune-analytics-mcp

使用说明

沙丘分析MCP服务器

将Dune Analytics数据连接到AI代理的mcp服务器。

特性

  • 工具:
    • get_latest_result:按ID获取沙丘查询的最新结果。
    • run_query:按ID执行沙丘查询并检索结果。
  • csv输出:所有结果都以CSV格式的字符串返回,以便于处理。

先决条件

  • Python 3.10+
  • 有效的Dune Analytics API密钥(从 沙丘分析)

安装

通过Smithery安装

通过以下方式自动安装克劳德桌面版沙丘分析 史密瑟里:

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)

    • 描述:检索指定沙丘查询的最新结果。
    • 输入: query_id (int)-沙丘查询的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中的命令示例

  • “获取沙丘查询1215383的最新结果”
  • “运行沙丘查询1215383”

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。