# ave-mcp

在 AI 对话里使用 [ave.ai](https://ave.ai) 的链上数据：查价格、看风险、多币对比、聪明钱动向、发现值得关注的币，也可以开启交易。

An MCP server for [ave.ai](https://ave.ai) on-chain data: prices, risk checks, multi-token comparison, smart-money flows and token discovery, with optional trading. Supports Solana, BSC, Ethereum and Base.

程序跑在你自己的电脑上，只调用 AVE 官方开放的 [Data API](https://ave-cloud.gitbook.io/data-api) 和 [Bot API](https://docs-bot-api.ave.ai/)，用的是你自己的 API key。

## 能做什么

直接用中文问就行，比如：

- 「STONK 这个币现在什么价格，风险怎么样？」
- 「对比一下 STONK 和 BONK」（附雷达图、走势叠加图、筹码分布图）
- 「Solana 上最近聪明钱在买什么？」
- 「Solana 上现在有什么值得关注的币？」
- 「帮我看看这个地址的持仓：<钱包地址>」

数字显示和 ave.ai 页面一致（如 `$78.7M`、`<0.01%`、`0.0₃123`）。每个结果都会附上这次消耗的 API 额度（CU）。

## 准备

1. 安装 [Node.js](https://nodejs.org) 20 或更高版本。
2. 到 [cloud.ave.ai](https://cloud.ave.ai) 注册，创建一个 API key（只查数据用免费套餐即可）。

## 接入 AI 客户端

**Claude Code**

```bash
claude mcp add ave -s user -e AVE_API_KEY=你的key -- npx -y ave-mcp
```

**Claude Desktop、Cursor、Trae、Cline** 等：在客户端的 MCP 配置里加入

```json
{
  "mcpServers": {
    "ave": {
      "command": "npx",
      "args": ["-y", "ave-mcp"],
      "env": { "AVE_API_KEY": "你的key" }
    }
  }
}
```

**Cherry Studio、Chatbox**：设置 → MCP 服务器 → 添加，类型选 stdio，命令 `npx`，参数 `-y ave-mcp`，环境变量 `AVE_API_KEY`。

**豆包、DeepSeek**：官方 App 不支持自定义 MCP。可以在 Trae（自带豆包、DeepSeek 模型）里使用，或在 Cherry Studio、Cline 里填 DeepSeek / 火山方舟的 API key 后按上面的方式接入。

> 如果客户端提示找不到 `npx`（常见于用 nvm 安装的 Node），把 `npx` 换成它的完整路径，可以在终端里用 `which npx` 查到。

## 工具

| 工具 | 做什么 | CU |
| --- | --- | --- |
| `search_token` | 按名称、符号、地址搜币 | 5 |
| `get_token` | 价格、市值、流动性、合约风险、安全分 | 15 |
| `get_prices` | 批量查价 | 100 |
| `get_kline` | K 线和走势统计，附图 | 10 |
| `get_holders` | Top100 持币和集中度 | 10 |
| `get_trending` | 热门榜、meme、主流币 | 5–10 |
| `get_trades` | 资金流、大单、加池撤池，附图 | 55–105 |
| `get_wallet` | 任意地址的持仓和盈亏 | 15 |
| `get_wallet_trades` | 某地址在某币上的交易 | 5–100 |
| `compare_tokens` | 2–5 个币六维对比，附三张图 | 约 85 / 币 |
| `token_risk_report` | 逐项风险体检 | 约 135 |
| `smart_money_flow` | 聪明钱共识，附热力图 | 约 205 |
| `discover` | 值得关注的币，附入选理由和风险点 | 约 800 |
| `portfolio_review` | 地址持仓体检 | 10 + 10 × 持仓数 |

分析结果缓存 10 分钟，追问不会重复扣 CU。分析类结果是基于公开链上数据的规则化统计，不构成投资建议。

## 开启交易（可选）

交易默认关闭，关闭时 AI 根本看不到交易工具。开启需要 Level 1 及以上套餐，在 `env` 里加上：

| 变量 | 说明 |
| --- | --- |
| `AVE_ENABLE_TRADING` | 设为 `1` |
| `AVE_BOT_API_SECRET` | Bot API secret |
| `AVE_ASSETS_ID` | 你的 Bot 钱包 assetsId |
| `AVE_MAX_TRADE_USD` | 单笔上限（美元），默认 100 |
| `AVE_DAILY_LIMIT_USD` | 每日上限（美元），默认 500 |

安全设计：

- **两步执行**：AI 只能生成待确认单，真正下单前必须由你亲手确认。客户端支持确认框时弹出确认框，不支持时在浏览器打开本机确认页。确认动作不经过 AI。
- **硬拦截**：疑似蜜罐、卖出税过高、大额撤池的币拒绝买入；超过单笔或每日上限直接拒绝。
- **转账白名单**：收款地址必须写在 `~/.ave-mcp/config.json` 的 `transferWhitelist` 里，AI 无法修改。
- **不碰私钥**：交易通过 AVE 托管的 Bot 钱包完成，本程序不需要也不读取任何私钥。
- **审计日志**：每次确认和下单记录在 `~/.ave-mcp/audit.log`。

建议第一次使用时把单笔上限设小，先用小额试一笔。

## 其它配置

| 变量 | 说明 | 默认 |
| --- | --- | --- |
| `AVE_BOT_API_KEY` | Bot API key，和 `AVE_API_KEY` 是同一把时不用填 | 同 `AVE_API_KEY` |
| `AVE_SLIPPAGE_BPS` | 默认滑点（100 = 1%） | 500 |
| `AVE_HOME` | 数据目录 | `~/.ave-mcp` |
| `AVE_FONT_FILE` | 图表用的中文字体文件（图里中文显示成方框时设置） | 自动查找 |

## License

MIT