true402/mcp-server
GitHub: true402/mcp-server
基于 x402 链上微支付协议的 MCP server，让 AI agent 以钱包身份按次付费调用 LLM 推理、Web 工具和 Base 链上分析等十余种服务。
Stars: 0 | Forks: 0
# @true402.dev/mcp-server
适用于 **[true402](https://true402.dev)** 机器原生市场的 MCP server — 让你的 agent 通过 [x402](https://x402.org)（在 Base 上使用 USDC 的 HTTP 402 微支付）获得按次付费的 AI 推理和 Web 工具访问权限。
无需账户，无需 API keys。该 agent 的 **wallet 即是其身份**：每个付费工具都会返回一个 HTTP 402 质询，服务器会签署一份 EIP-3009 USDC 授权，随后在链上完成结算。你可以配置一个已注资的 wallet 来自动支付；或者在未配置的情况下运行，此时付费工具会返回具体的支付要求，而不是直接报错。
## 工具
| 工具 | 价格 | 功能描述 |
|------|-------|--------------|
| `chat` | 按 token + 3% | 兼容 OpenAI 的多模型 LLM 推理 |
| `list_models` | 免费 | 列出可用模型及定价 |
| `token_safety` | $0.005 | 针对 Base 上 ERC-20 的抽地毯/蜜罐预检 → 0–100 分数、风险等级、标记、流动性深度以及买卖蜜罐模拟 |
| `seo_audit` | $0.015 | 页面的 SEO + GEO（生成式引擎优化）审计 → 结构化报告 |
| `web_extract` | $0.005 | 获取 URL → 纯文本 + markdown + 链接 + 元数据 |
| `link_preview` | $0.003 | 获取 URL → Open Graph / 展开卡片 |
| `robots_check` | $0.003 | 网站的 AI 爬虫策略（GPTBot、ClaudeBot、Google-Extended、PerplexityBot 等）+ sitemaps + llms.txt |
| `headers_check` | $0.003 | HTTP 安全标头分析（HSTS、CSP 等）+ 0–100 分数 |
| `new_pairs` | $0.003 | Base DEX 上新创建的交易对（Uniswap V3 / Aerodrome）— 最新 token 发行 |
| `liquidity_pulls` | $0.003 | Base 资金池的移除流动性 / 抽地毯警报 |
| `whale_swaps` | $0.005 | Base 上按 USD 规模计算的大额交易（swap）— 巨鲸流向 |
| `token_report` | $0.01 | 更完整的链上 token 报告 |
工具会从实时目录中**自动发现**，因此新的市场档口会自动出现。
价格仅供参考；实时的 402 质询具有最终决定权。
## 示例：将 token 安全性添加到你的 agent
[`examples/token-safety/`](examples/token-safety/) 中的即复制即粘贴参考 — 这是一个与框架无关的 x402 客户端，外加一个即插即用的 LangChain 工具，能够以每次 $0.005 的价格对任何 Base token 进行抽地毯/蜜罐检查。
## 安装
需要 Node.js ≥ 20。通过 stdio 运行 — 使用 `npx` 将任何 MCP 客户端指向它。
### Claude Desktop / Claude Code
添加到你的 MCP 配置中（`claude_desktop_config.json`，或 Claude Code 的 `.mcp.json`）：
```
{
"mcpServers": {
"true402": {
"command": "npx",
"args": ["-y", "@true402.dev/mcp-server"],
"env": {
"WALLET_PRIVATE_KEY": "0xYOUR_FUNDED_BASE_WALLET_KEY"
}
}
}
}
```
### Cursor / Cline / 其他 MCP 客户端
操作类似 — 命令为 `npx`，参数为 `["-y", "@true402.dev/mcp-server"]`，并设置 `WALLET_PRIVATE_KEY` 环境变量。
## 配置
| 环境变量 | 默认值 | 描述 |
|---------|---------|-------------|
| `SERVER_URL` | `https://true402.dev/api` | true402 API 基础地址。可覆盖此项以指向自托管实例。 |
| `WALLET_PRIVATE_KEY` | _(无)_ | 已注资的 **Base** wallet 私钥，用于签署 x402 支付。需要 **USDC**（gas 由 facilitator 赞助 — 不需要 ETH）。若不提供，付费工具将返回 402 要求而不是直接支付。 |
## 支付运作方式
1. 工具在不附带支付的情况下调用 true402 endpoint。
2. 服务器回复 `402` 以及可接受的支付选项（Base 上的 USDC）。
3. 此 MCP server 使用你的 wallet 签署 EIP-3009 `transferWithAuthorization`。
4. 它会带上已签署的 `X-PAYMENT` 标头重试；服务会进行验证并响应。
5. 结算在链上发生。你的 wallet 仅支付 USDC — gas 由 facilitator 赞助。
## 链接
- 市场：
- 实时工具目录：
- x402 协议：
## 许可证
MIT
标签：AI智能体, MCP服务, MITM代理, Web3, 加密货币支付, 区块链, 支付协议, 自动化攻击, 链上分析