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

1. 创建并激活虚拟环境:

   python3 -m venv .venv
   source .venv/bin/activate  # Windows: .venv\Scripts\activate

1. 安装依赖:

   pip install -e .

1. 设置 TapTools API 密钥:

- 选项 A: 添加到 .env 文件:

     TAPTOOLS_API_KEY=your-real-taptools-api-key

- 选项 B: 设置环境变量:

     export TAPTOOLS_API_KEY="your-real-taptools-api-key"

1. 运行 MCP 服务器:

   python -m taptools_api_mcp

调试方式

1. 测试连接:

   python test_connection.py

1. 使用 MCP 客户端测试工具:

   mcp cli

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

   > tool verify_connection

或

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