MCP-ATP: Model Context Protocol Server for IQ AI Agent Tokenization Platform

🤖 MCP-ATP：Agent Tokenization Platform

📖 概述

MCP-ATP 服务可让 AI Agent 与 IQ AI 的 Agent Tokenization Platform (ATP) 交互。此服务全面提供 Agent 统计信息、代币持仓、交易功能和 Agent 日志。

此服务通过实现 Model Context Protocol (MCP)，让大语言模型 (LLM) 直接通过上下文窗口发现 AI Agent、分析 Agent 表现、交易 Agent 代币并管理 Agent 日志，从而弥合 AI 与去中心化 Agent 代币化之间的鸿沟。

✨ 功能

• Agent 发现：搜索并获取 AI Agent 的统计信息和详情。
• 投资组合跟踪：监控用户持有的 ATP AI 代币。
• 代币交易：使用 IQ 作为基础货币，买卖 AI Agent 代币。
• 日志管理：获取特定 AI Agent 的日志并添加日志。

📦 安装

🚀 使用 pnpm dlx（推荐）

无需全局安装即可使用此服务：

pnpm dlx @iqai/mcp-atp

🔧 从源代码构建

git clone https://github.com/IQAIcom/mcp-atp.git
cd mcp-atp
pnpm install
pnpm run build

⚡ 使用 MCP 客户端运行

将以下配置添加到 MCP 客户端设置中（例如 claude_desktop_config.json）。

📋 最简配置

{
  "mcpServers": {
    "atp": {
      "command": "pnpm",
      "args": ["dlx", "@iqai/mcp-atp"],
      "env": {
        "ATP_WALLET_PRIVATE_KEY": "your_wallet_private_key_here"
      }
    }
  }
}

⚙️ 高级配置（本地构建）

{
  "mcpServers": {
    "atp": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-atp/dist/index.js"],
      "env": {
        "ATP_WALLET_PRIVATE_KEY": "your_wallet_private_key_here",
        "ATP_API_KEY": "your_atp_api_key_if_needed"
      }
    }
  }
}

🔐 配置（环境变量）

变量	必填	说明	默认值
ATP_WALLET_PRIVATE_KEY	是*	用于交易和查询持仓的钱包私钥	-
ATP_API_KEY	否	某些后端服务所需的 API 密钥	-

*ATP_GET_AGENT_POSITIONS、ATP_BUY_AGENT、ATP_SELL_AGENT 工具需要此项。

**安全提示：**请极其谨慎地处理私钥。确保将其安全存储，并且仅提供给可信的 MCP 客户端配置。

💡 使用示例

🔍 Agent 发现

• “ATP 上排名靠前的 AI Agent 有哪些？”
• “获取代币合约地址为 0x123... 的 Agent 统计信息。”
• “按名称或类别搜索 AI Agent。”

📊 投资组合管理

• “我目前持有哪些 ATP AI 代币？”
• “显示我在钱包 0xabc... 中的持仓。”

💹 交易

• “用价值 100 IQ 的资金购买 0x123... 对应的 Agent 代币。”
• “卖出我在 Agent 0x456... 中的持仓。”

📝 日志管理

• “获取 Agent 0x123... 的最新日志。”
• “为我的 Agent 添加一条新日志。”

🛠️ MCP 工具

ATP_ADD_AGENT_LOG

为特定 AI Agent 添加一条新日志。需要将 API 密钥作为参数提供。

参数	类型	必填	说明
agentTokenContract	string	是	Agent 代币的合约地址。
content	string	是	日志消息的内容。
txHash	string	否	与此日志条目关联的可选交易哈希。
chainId	integer	否	与此日志条目关联的可选链 ID。

ATP_AGENT_STATS

获取 ATP 平台上指定 AI Agent 的统计信息和详情。

参数	类型	必填	说明
tokenContract	string	是	Agent 代币的合约地址（例如 0x123...abc）。

ATP_BUY_AGENT

使用 IQ 作为基础货币购买 AI Agent 代币。

参数	类型	必填	说明
tokenContract	string	是	要购买的 Agent 代币合约地址。
amount	string	是	用于购买 Agent 代币的基础货币 (IQ) 数量，以 wei 为单位指定（例如，'1000000000000000000' 表示 1 IQ）。

ATP_GET_AGENT_LOGS

检索特定 AI Agent 的日志，并支持分页。

参数	类型	必填	描述
agentTokenContract	string	是	Agent 代币的合约地址。
page	integer	否	分页页码。默认为 1。
limit	integer	否	每页的日志数量。默认为 10。

ATP_GET_AGENT_POSITIONS

检索用户的持仓

无参数

ATP_GET_AGENTS

从 ATP 平台获取 AI Agent 列表，并可选择排序和限制数量。

参数	类型	必填	默认值	描述
sort	string	否

    按市值、持有者数量或推理次数对 Agent 排序。
    可选项如下：
    - mcap：按市值排序
    - holders：按持有者数量排序
    - inferences：按推理次数排序
    如果未指定，默认按市值排序。
   |

| limit | integer | 否 | 100 | |

ATP_SELL_AGENT

将 AI Agent 代币卖回协议。

参数	类型	必填	描述
tokenContract	string	是	要出售的 Agent 代币合约地址。
amount	string	是	要出售的 Agent 代币数量，以 wei 为单位指定（例如，1 个代币为 '1000000000000000000'）。

👨‍💻 开发

🏗️ 构建项目

pnpm run build

👁️ 开发模式（监视）

pnpm run watch

✅ 代码检查与格式化

pnpm run lint
pnpm run format

📁 项目结构

• src/tools/：各个工具的定义
• src/services/：API 客户端和业务逻辑
• src/lib/：共享实用工具
• src/index.ts：服务入口文件

📚 资源

• IQ AI Agents Platform
• Model Context Protocol (MCP)
• IQ Wiki

⚠️ 免责声明

本项目涉及基于区块链的金融操作。用户应谨慎行事，并独立核实所有交易。交易 Agent 代币存在风险。

📄 许可证

ISC