内容
# 🛡️ RugCheck AI — 链上代币安全性检测，用于 Solana AI 智能体
一个轻量级的 MCP 服务器，直接从 Solana 区块链读取代币的铸造信息，以筛查常见的 Rug 和 Honeypot 陷阱 **在** 您的智能体交易之前 —— 活跃的铸造/冻结权限和危险的 Token-2022 扩展（永久委托、转移钩、不可转移、可暂停）—— 然后，对于通过的代币，构建一个 **未签名** 的 Jupiter 交易，带有小额 Jito 小费，以便更快地被纳入。您签名；服务器从不持有密钥。
## 快速开始（30 秒）
无需安装，无需 API 密钥。只需将您的智能体指向远程端点：
```
https://web-production-58d585.up.railway.app/mcp
```
然后，在购买前，提出一个问题：
```
scan_token("DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263") # BONK
→ { 判决: "安全", 安全评分: 100, 可出售: true, 风险: ["未发现红旗"] }
```
`安全` → 清晰。`谨慎` → 阅读风险。`危险` → 不要购买。这就是整个循环。
## 看看它如何捕获 Rug
三个真实的主网代币，每个代币调用一次 `scan_token`（扫描于 2026-06-17 — 重新运行以验证，实时状态变更）：
| 代币 | 判决 | 为什么 |
|---|---|---|
| **BONK** | `安全` · 100 | 权限已放弃，流动性好，可出售 — 未发现红旗 |
| **USDC** | `谨慎` · 70 | 发行人保留活跃的铸造 **和** 冻结权限 — 您的余额 **可以** 被冻结 |
| 新代币 `24tF…i9pump` | `危险` · 20 | **无出售路线** （Honeypot），**100%** 由一个钱包持有，**$0** 流动性 |
Honeypot 是重要的：您可能会购买它，但永远无法出售。RugCheck AI 在您的智能体花费一分钱之前就标记了它 **即使** 代币太新，无法在其他地方索引。即使 USDC 返回 `谨慎`，而不是 `安全`，因为发行人仍然可以冻结您的余额 — 判决告诉您真相，而不是营销标签。
## 工具
**筛查**
- `scan_token` — 一次调用提供完整的安全报告：权限、Token-2022 陷阱、Honeypot、流动性和持有者集中度 → 安全/谨慎/危险 + 0-100 分数
- `is_safe` — 快速的 yes/no 门槛：交易前的一个布尔值
- `verify_token_safety` — 链上审计：铸造/冻结权限 + Token-2022 陷阱 + 实时市场
- `check_authorities` — 铸造/冻结权限和扩展检测
- `simulate_sell` — 代币实际上可以出售吗？（Honeypot 检查）
- `simulate_trade` — 完整的往返（买入然后卖出）：实际进出成本和往返损失 %
- `check_liquidity` — DEX 流动性，24 小时交易量，年龄，买入/卖出
- `holders_breakdown` — 顶级持有者集中度（倾销风险）
- `token_age` — 新鲜度 + 实际交易活动
- `rug_forecast` — 启发式 Rug 预计时间：概率 + 紧急窗口 + 因素
- `scammer_dna` — 意图评分（0-100）：代币结构有多像故意诈骗
- `check_deployer` — 持有代币权力钱包
- `compare_tokens` — 按安全性从高到低排序一组代币
- `batch_scan` — 一次扫描最多 10 个代币，每个代币一个报告
**执行**
- `execute_safe_swap` — 重新筛查铸造，然后构建一个带有 Jito 小费的 Jupiter 交换（未签名）；拒绝危险代币
## 连接
**远程（Streamable HTTP）** — 无需安装，将您的智能体指向：
```
https://web-production-58d585.up.railway.app/mcp
```
在 [官方 MCP 注册表](https://registry.modelcontextprotocol.io) 上列为
`io.github.MrWizardlyLoaf/rugcheck-ai`。
**自托管：**
```bash
pip install -r requirements.txt
SOLANA_RPC=<您的 RPC URL> python server.py
```
### 添加到您的智能体
**Cline / Claude Dev（VS Code）** — 在 `cline_mcp_settings.json` 中：
```json
{ "mcpServers": { "rugcheck-ai": { "url": "https://web-production-58d585.up.railway.app/mcp" } } }
```
**Claude Desktop** — 在 `claude_desktop_config.json` 中：
```json
{ "mcpServers": { "rugcheck-ai": { "command": "npx", "args": ["-y", "mcp-remote", "https://web-production-58d585.up.railway.app/mcp"] } } }
```
**Cursor** — 设置 → MCP → 添加 → Streamable HTTP，然后粘贴端点 URL。
**任何 MCP 客户端** — 它是一个标准的 Streamable HTTP MCP 服务器；将您的客户端指向 `/mcp` 端点，15 个工具就会出现。
## 为什么
大多数智能体都盲目交易 Solana 代币。RugCheck AI 调用 `getAccountInfo` 并直接从链上读取铸造信息和权限，以及 Token-2022 扩展，这样您在购买前就能获得真实的判决，而不是 `未知` —— 实时铸造或冻结权限在您购买前就会被标记，而不是之后。
## 何时使用
您的智能体需要在花费一分钱之前回答：
- *这个 Solana 代币是否安全购买 — 还是一个 Rug Pull？*
- *这是一个 Honeypot 吗 — 我真的能够在购买后出售吗？*
- *铸造是否有活跃的冻结/铸造权限，可以困住或稀释我？*
- *是否有隐藏的 Token-2022 陷阱（永久委托、转移钩），可以耗尽我？*
- *自主交易智能体的预交易筛查/代币尽职调查。*
为 AI 交易智能体、狙击手和购买 SPL / Token-2022 代币的机器人而建，需要在进入前进行快速的链上 Rug 检查 — 然后在代币通过后进行筛选的 Jupiter 路线。
## 常见问题
**如何检查 Solana 代币是否安全购买？**
调用 `scan_token(mint)` — 一个调用返回一个 SAFE / CAUTION / DANGER 判决，涵盖铸造/冻结权限、Token-2022 陷阱、Honeypot（可出售性）、流动性和持有者集中度，以及 0-100 安全评分。
**如何在购买前检测 Honeypot？**
`simulate_sell(mint)` 检查是否存在活跃的出售路线 — 没有出售路线的代币实际上是一个 Honeypot，即使链上没有任何正式的出售阻塞。
**如何检查持有者集中度/鲸鱼倾销风险？**
`holders_breakdown(mint)` 报告最大钱包及其控制的供应份额 — 高集中度意味着一个持有者可以使价格下跌。
**如何知道代币是否是 Rug Pull？**
`rug_forecast(mint)` 给出一个启发式的 Rug 概率和紧急窗口，从真实信号（权限、Token-2022 陷阱、集中度、出售压力、年龄）。`check_authorities` 和 `check_deployer` 显示谁真正持有代币的权力。
**它是否适用于新的/刚刚启动的代币？**
是的 — 它直接读取链上的铸造信息（`getAccountInfo`），因此您对一个代币的判决是真实的，即使它太新而无法在其他地方索引。`token_age` 显示新鲜度和实际交易活动。
**它是否触及我的钱包或签名？**
否。筛查是只读的；`execute_safe_swap` 仅为您构建一个 UNSIGNED 交易，您签名 — 服务器从不持有密钥，从不签名，从不发送。
**它是免费的吗？ 我需要 API 密钥吗？**
远程服务器，无需安装，无需 API 密钥。将您的智能体指向端点并调用工具。
## 状态
v1.2.0 — 工作中，积极开发，CI 测试。开源，可审计 — 筛查工具是只读的（`getAccountInfo`）；`execute_safe_swap` 仅为您构建一个 UNSIGNED 交易，您签名。
*MIT 许可。可自我托管。为 Solana 交易智能体而建。*
