TapTools API MCP

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

特征

• 异步实现：使用现代 Python 异步模式和 httpx 实现非阻塞 IO。
• 安全身份验证：从环境变量或.env文件中读取TAPTOOLS_API_KEY 。
• MCP-Ready ：将 TapTools 功能公开为任何符合 MCP 的客户端可访问的“工具”。
• 代币操作：定价、顶级代币、市值数据、交易量统计等。
• NFT 运营：NFT 收集统计、交易、上市、分发等。
• 市场数据：交易量、地址、持有者等的汇总统计数据。
• 集成和链上：访问链上数据、区块信息、事件、DEX 对等。
• 钱包数据：投资组合头寸、代币/NFT 持有量、交易历史、交易。

快速入门

1. 克隆存储库：
   git clone https://github.com/yourusername/taptools-api-mcp.git cd taptools-api-mcp
2. 创建并激活虚拟环境：
   python3 -m venv .venv source .venv/bin/activate # On 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
   默认情况下，它将在标准输入/输出（stdio）上运行以进行 MCP 集成。
6. 测试连接（可选）：
   python test_connection.py

使用示例

如果您有 MCP 客户端（例如mcp Python CLI 工具），您可以启动服务器并调用任何可用的工具：

一旦进入mcp cli ，您可以调用如下工具：

这将验证您的 TapTools API 密钥是否有效且可访问。

或者，例如，获取代币市值信息：

您应该收到包含代币市值、价格、供应量等的 JSON 数据。

API 文档：MCP 工具

以下是可用的 MCP 工具列表、它们的参数和简要说明。调用这些工具时必须使用正确的 JSON 负载。所有 JSON 请求必须与src/taptools_api_mcp/models/中的 Pydantic 模型匹配。

1. verify_connection

• 描述：验证 TapTools API 身份验证。
• 参数：（无参数。）
• 示例用法：
  { }

2. get_token_mcap

• 描述：获取代币市值信息。
• 参数（ TokenMcapRequest ）：
  { "unit": "string" // required: token unit identifier }
• 示例用法：
  { "unit": "lovelace" }

3. get_token_holders

• 描述：获取代币持有者的总数。
• 参数（ TokenHoldersRequest ）：
  { "unit": "string" // required: token unit identifier }
• 示例用法：
  { "unit": "lovelace" }

4. get_token_holders_top

• 描述：获取顶级代币持有者。
• 参数（ TokenTopHoldersRequest ）：
  { "unit": "string", // required "page": "number", // optional (default 1) "per_page": "number"// optional (default 20) }
• 示例用法：
  { "unit": "some_token_unit", "page": 1, "per_page": 5 }

5. get_nft_asset_sales

• 描述：获取NFT资产销售历史记录。
• 参数（ NFTAssetSalesRequest ）：
  { "policy": "string", // required: NFT policy ID "name": "string" // optional: NFT name }
• 示例用法：
  { "policy": "abc123polid", "name": "coolNFT" }

6. get_nft_collection_stats

• 描述：获取 NFT 收集统计数据。
• 参数（ NFTCollectionStatsRequest ）：
  { "policy": "string" // required: NFT collection policy ID }
• 示例用法：
  { "policy": "abc123polid" }

7. get_market_stats

• 描述：获取整个市场的统计数据。
• 参数（ MarketStatsRequest ）：
  { "quote": "string" // optional, default "ADA" }
• 示例用法：
  { "quote": "USD" }

8. get_integration_asset

• 描述：通过 ID 获取资产详细信息（集成端点）。
• 参数（ IntegrationAssetRequest ）：
  { "id": "string" // required: ID of the asset }
• 示例用法：
  { "id": "asset123abc" }

9. get_asset_supply

• 描述：获取链上资产供应。
• 参数（ AssetSupplyRequest ）：
  { "unit": "string" // required: token unit identifier }
• 示例用法：
  { "unit": "lovelace" }

10. get_wallet_portfolio

• 描述：获取钱包投资组合头寸。
• 参数（ WalletPortfolioPositionsRequest ）：
  { "address": "string" // required: wallet address }
• 示例用法：
  { "address": "addr1xyz..." }

（如果需要，可以以相同的格式添加代币、NFT、链上等附加端点。有关更多可能的请求，请参阅src/taptools_api_mcp/models/文件夹。）

部署

您可以将此 Python MCP 服务器容器化或托管在 AWS ECS、Azure 容器实例或 Google Cloud Run 等服务上。请确保将您的TAPTOOLS_API_KEY安全地存储为密钥。对于基于 Docker 的部署：

注意：根据 MCP 规范，服务器默认监听 stdio。对于高级部署或自定义集成，您可以根据环境需求调整server.py以使用其他传输方式（例如套接字）。