内容
# 🤖 MCP-ATP: 智能体代币化平台
[](https://www.npmjs.com/package/@iqai/mcp-atp)
[](https://opensource.org/licenses/ISC)
## 📖 概述
MCP-ATP 服务器使 AI 智能体能够与 IQ AI 的 [智能体代币化平台 (ATP)](https://agents.iq.wiki) 进行交互。该服务器提供对智能体统计数据、代币仓位、交易功能和智能体日志的全面访问。
通过实施模型上下文协议（MCP），该服务器允许大型语言模型（LLM）直接在其上下文窗口中发现 AI 智能体、分析智能体性能、交易智能体代币和管理智能体日志，从而弥合了 AI 和去中心化智能体代币化之间的差距。
## ✨ 功能
* **智能体发现**：搜索和检索 AI 智能体的统计数据和详细信息。
* **投资组合跟踪**：监控用户在 ATP AI 代币中的持仓。
* **代币交易**：使用 IQ 作为基础货币买卖 AI 智能体代币。
* **日志管理**：检索和添加特定 AI 智能体的日志。
## 📦 安装
### 🚀 使用 pnpm dlx（推荐）
无需全局安装即可使用此服务器：
```bash
pnpm dlx @iqai/mcp-atp
```
### 🔧 从源码构建
```bash
git clone https://github.com/IQAIcom/mcp-atp.git
cd mcp-atp
pnpm install
pnpm run build
```
## ⚡ 使用 MCP 客户端运行
在您的 MCP 客户端设置中添加以下配置（例如 `claude_desktop_config.json`）。
### 📋 最小配置
```json
{
"mcpServers": {
"atp": {
"command": "pnpm",
"args": ["dlx", "@iqai/mcp-atp"],
"env": {
"ATP_WALLET_PRIVATE_KEY": "您的钱包私钥"
}
}
}
}
```
### ⚙️ 高级配置（本地构建）
```json
{
"mcpServers": {
"atp": {
"command": "node",
"args": ["/绝对路径/to/mcp-atp/dist/index.js"],
"env": {
"ATP_WALLET_PRIVATE_KEY": "您的钱包私钥",
"ATP_API_KEY": "您的 atp api 密钥（如果需要）"
}
}
}
}
```
## 🔐 配置（环境变量）
| 变量 | 是否必需 | 描述 | 默认值 |
| :--- | :--- | :--- | :--- |
| `ATP_WALLET_PRIVATE_KEY` | 是* | 用于交易和仓位查询的钱包私钥 | - |
| `ATP_API_KEY` | 否 | 某些后端服务的 API 密钥 | - |
* `ATP_GET_AGENT_POSITIONS`、`ATP_BUY_AGENT`、`ATP_SELL_AGENT` 工具必需。
**安全注意事项：** 请极度小心地处理私钥。确保私钥存储安全，仅提供给受信任的 MCP 客户端配置。
## 💡 使用示例
### 🔍 智能体发现
* "ATP 上有哪些顶级 AI 智能体？"
* "获取代币合约为 0x123... 的智能体的统计数据..."
* "按名称或类别搜索 AI 智能体。"
### 📊 投资组合管理
* "我在 ATP AI 代币中当前的仓位是什么？"
* "显示钱包 0xabc... 中的我的持仓。"
### 💹 交易
* "购买 100 IQ 价值的 0x123... 智能体代币。"
* "出售我在 0x456... 智能体中的仓位。"
### 📝 日志管理
* "获取 0x123... 智能体的最新日志..."
* "为我的智能体添加新的日志条目。"
## 🛠️ MCP 工具
<!-- AUTO-GENERATED TOOLS START -->
### `ATP_ADD_AGENT_LOG`
为特定 AI 智能体添加新的日志条目。需要 API 密钥作为参数。
| 参数 | 类型 | 是否必需 | 描述 |
|-----------|------|----------|-------------|
| `agentTokenContract` | 字符串 | 是 | 智能体代币的合约地址。 |
| `content` | 字符串 | 是 | 日志消息的内容。 |
| `txHash` | 字符串 | 否 | 与此日志条目相关的可选交易哈希。 |
| `chainId` | 整数 | 否 | 与此日志条目相关的可选链 ID。 |
### `ATP_AGENT_STATS`
获取给定 AI 智能体在 ATP 平台上的统计数据和详细信息。
| 参数 | 类型 | 是否必需 | 描述 |
|-----------|------|----------|-------------|
| `tokenContract` | 字符串 | 是 | 智能体代币的合约地址（例如 0x123...abc）。 |
### `ATP_BUY_AGENT`
使用 IQ 作为基础货币购买 AI 智能体代币。
| 参数 | 类型 | 是否必需 | 描述 |
|-----------|------|----------|-------------|
| `tokenContract` | 字符串 | 是 | 要购买的智能体代币的合约地址。 |
| `amount` | 字符串 | 是 | 以 wei 单位表示的用于购买智能体代币的基础货币（IQ）金额（例如 '1000000000000000000' 表示 1 IQ）。 |
### `ATP_GET_AGENT_LOGS`
检索特定 AI 智能体的日志，支持分页。
| 参数 | 类型 | 是否必需 | 描述 |
|-----------|------|----------|-------------|
| `agentTokenContract` | 字符串 | 是 | 智能体代币的合约地址。 |
| `page` | 整数 | 否 | 分页的页码。默认为 1。 |
| `limit` | 整数 | 否 | 每页日志数量。默认为 10。 |
### `ATP_GET_AGENT_POSITIONS`
检索用户的仓位
_无参数_
### `ATP_GET_AGENTS`
从 ATP 平台检索 AI 智能体列表，支持可选排序和限制。
| 参数 | 类型 | 是否必需 | 默认值 | 描述 |
|-----------|------|----------|---------|-------------|
| `sort` | 字符串 | 否 | |
按市值、持有者数量或推理次数对智能体进行排序。
可用选项：
- mcap：按市值排序
- holders：按持有者数量排序
- inferences：按推理次数排序
如果未指定，默认为市值排序。
|
| `limit` | 整数 | 否 | 100 | |
### `ATP_SELL_AGENT`
将 AI 智能体代币卖回协议。
| 参数 | 类型 | 是否必需 | 描述 |
|-----------|------|----------|-------------|
| `tokenContract` | 字符串 | 是 | 要出售的智能体代币的合约地址。 |
| `amount` | 字符串 | 是 | 要出售的智能体代币数量，以 wei 单位表示（例如 '1000000000000000000' 表示 1 代币）。 |
<!-- AUTO-GENERATED TOOLS END -->
## 👨💻 开发
### 🏗️ 构建项目
```bash
pnpm run build
```
### 👁️ 开发模式（监听）
```bash
pnpm run watch
```
### ✅ 校验和格式化
```bash
pnpm run lint
pnpm run format
```
### 📁 项目结构
* `src/tools/`：单个工具定义
* `src/services/`：API 客户端和业务逻辑
* `src/lib/`：共享实用程序
* `src/index.ts`：服务器入口点
## 📚 资源
* [IQ AI 智能体平台](https://agents.iq.wiki)
* [模型上下文协议（MCP）](https://modelcontextprotocol.io)
* [IQ 维基](https://iq.wiki)
## ⚠️ 免责声明
该项目涉及基于区块链的金融操作。用户应谨慎行事，并独立验证所有交易。交易智能体代币存在风险。
## 📄 许可证
[ISC](LICENSE)
MCP 市场