TapTools API MCP 服务

TapTools API MCP 是一个基于 Python 的模型上下文协议(MCP)服务器,提供对 TapTools API 的访问,使大型语言模型(如 Claude 或 GPT)能够获取 Cardano 相关的数据(如代币、NFT、市场信息等)。该服务器将 TapTools API 操作标准化为 MCP "工具",便于集成到 AI 工作流程中。

  • by brianbell-x
  • 更新于
在 GitHub 查看 brianbell-x/tadpoletools-mcp

使用说明

基本能力

产品定位

TapTools API MCP 是一个为大型语言模型提供 Cardano 区块链数据访问的中间件服务。

核心功能

  • 异步实现:使用现代 Python 异步模式和 httpx 实现非阻塞 IO。
  • 安全认证:从环境变量或 .env 文件中读取 TAPTOOLS_API_KEY。
  • MCP 就绪:将 TapTools 功能暴露为任何符合 MCP 标准的客户端可访问的"工具"。
  • 代币操作:价格、顶级代币、市值数据、交易量统计等。
  • NFT 操作:NFT 集合统计、交易、列表、分布等。
  • 市场数据:交易量、地址、持有者等的聚合统计。
  • 集成和链上数据:访问链上数据、区块信息、事件、DEX 对等。
  • 钱包数据:投资组合头寸、代币/NFT 持有量、交易历史、交易记录。

适用场景

  • 为 AI 模型提供 Cardano 区块链数据访问
  • 构建 Cardano 数据分析工具
  • 开发 Cardano 相关的自动化交易系统
  • 创建 Cardano 钱包管理应用

使用教程

使用依赖

  1. 确保已安装 Python 3.10 或更高版本
  2. 确保已安装 git

安装教程

  1. 克隆仓库:

    git clone https://github.com/yourusername/taptools-api-mcp.git
    cd taptools-api-mcp
    
  2. 创建并激活虚拟环境:

    python3 -m venv .venv
    source .venv/bin/activate  # Windows: .venv\Scripts\activate
    
  3. 安装依赖:

    pip install -e .
    
  4. 设置 TapTools API 密钥:

    • 选项 A: 添加到 .env 文件:
      TAPTOOLS_API_KEY=your-real-taptools-api-key
      
    • 选项 B: 设置环境变量:
      export TAPTOOLS_API_KEY="your-real-taptools-api-key"
      
  5. 运行 MCP 服务器:

    python -m taptools_api_mcp
    

调试方式

  1. 测试连接:

    python test_connection.py
    
  2. 使用 MCP 客户端测试工具:

    mcp cli
    

    然后在 CLI 中调用工具,例如:

    > tool verify_connection
    

    或

    > tool get_token_mcap {"unit": "lovelace"}