内容
# @melis-ai/x402-tools-mcp
[](https://www.npmjs.com/package/@melis-ai/x402-tools-mcp)
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
[](https://x402.org)
[](https://agents.melis.ai)
代理构建者的基础设施工具。**22 种按次付费的实用工具** 作为 MCP 服务器提供服务 — 爬取、验证、嵌入、存储、审核、通知、转换、防止循环。**无需账号，无需 API 密钥，无需订阅。** 通过 [x402 协议](https://x402.org) 在 Base 上使用 USDC 支付。
```bash
npx @melis-ai/x402-tools-mcp
```
→ 完整的目录，价格和实时示例： **[agents.melis.ai](https://agents.melis.ai)**
→ 标准的 5 步 RAG 流水线： **[agents.melis.ai/pipelines/rag](https://agents.melis.ai/pipelines/rag)**
→ 5 分钟快速入门： **[agents.melis.ai/docs/getting-started](https://agents.melis.ai/docs/getting-started)**
---
## 工具目录（22 个）
| 工具 | 价格（USDC） | 描述 |
|------|-------------|-------------|
| `list_services` | 免费 | 返回完整的目录，价格和端点 URL |
| `cacheserve` | $0.001 | 使用服务器端缓存获取 URL — 避免冗余的源头请求 |
| `docconvert_text` | $0.001 | 格式转换：md↔html，json↔csv，html→txt 等 |
| `intentflow` | $0.001 | 多代理委托的上下文交接中继（异步，返回 retrieve_url） |
| `memoryserve_write` | $0.001 | 将文本 + 嵌入存储在 Qdrant + SQLite 中，按 `agent_id` 命名 |
| `memoryserve_query` | $0.001 | 通过语义查询回忆最相似的记忆 |
| `memscrub` | $0.001 | 扫描检索的 RAG 内容以防止间接提示注入（10 种模式） |
| `notifyrelay_webhook` | $0.001 | 向 URL 发送 JSON 有效载荷，可选 HMAC-SHA256 签名 |
| `schemagate` | $0.001 | 验证 JSON 响应是否符合 JSON 模式，失败时返回提示 |
| `loopwall_hop` | $0.0005 | 验证签名多代理链的一个跳跃（循环 / 预算执行） |
| `loopwall_issue` | $0.001 | 在链开始时发布带有预算 + 跳跃上限的签名作业信封 |
| `imageguard` | $0.002 | NSFW 图片分类（多类审核正在规划） |
| `notifyrelay_telegram` | $0.002 | 向已知的聊天 ID 发送 Telegram 消息 |
| `promptguard` | $0.002 | 评估不受信任的输入以防止提示注入风险（0–100） |
| `structextract` | $0.002 | 从 HTML 中提取结构化 JSON — 表格，链接，电子邮件，电话 |
| `xaudit` | $0.002 | 使用加密签名的证书验证 API 响应内容 |
| `docconvert_pdf` | $0.005 | 将 HTML 或 markdown 转换为 PDF（base64 输出） |
| `kyaoracle` | $0.005 | 链上信任分数（0–100）适用于以太坊 / Base 钱包地址 |
| `linkrisk` | $0.005 | URL 风险配置文件 — 启发式钓鱼信号，跳转跟踪 |
| `markdownopt` | $0.005 | 将 URL 或 HTML 转换为干净的 LLM 就绪 markdown（~70% token 减少） |
| `notifyrelay_email` | $0.005 | 通过 Resend 发送事务性电子邮件（允许列出，限速） |
| `embedpay` | $0.00005 / 1k tokens | OpenAI text-embedding-3-small 封装，批量层可用 |
| `linksafe` | $0.01 | 通过 Playwright 沙盒 + VirusTotal 进行确定性的 URL 安全检查 |
| `scrapepay` | $0.01 | 通过 Playwright 进行网页提取（robots.txt 强制执行，SSRF 安全） |
| `pdf_render` | $0.49 | 高保真 URL 或 HTML → PDF 通过 Playwright |
22 种服务。实时价格和实时钱包 [在 Basescan 上](https://basescan.org/address/0x1C680703D6cF7dfC9FEABb5AA28E64B869ddB3bC#tokentxns)。
---
## 为什么选择 x402，为什么按次付费
- **无注册税。** 这里的每个工具都可以在您的钱包中有 USDC 时立即使用。无需预备账户，无需轮换 API 密钥，无需预测订阅层。
- **仅在成功时收费。** 每个服务仅在 HTTP 2xx 且内容非空时结算付款。失败的调用费用为零 — 您的重试预算得以保留。
- **自然组合。** ScrapePay → MarkdownOpt → EmbedPay → MemoryServe → MEMSCRUB 是标准的 RAG 流水线。每个步骤的付款都是独立且可链上验证的。
- **MCP 原生。** 一次安装，所有 22 种工具都出现在 Claude Desktop，Cursor，Cline，Continue，Claude Code 或任何 MCP 感知的代理运行时中。
- **无供应商锁定。** x402 是 Linux 基金会协议（2026 年 4 月），由 Google，AWS，Stripe，Visa，Mastercard 共同签署。其他提供商将提供 x402 服务；您的钱包客户端与所有这些服务商一起使用。
---
## 在 Claude Desktop 上安装
将以下内容添加到您的 `claude_desktop_config.json` 中：
```json
{
"mcpServers": {
"x402-tools": {
"command": "npx",
"args": ["@melis-ai/x402-tools-mcp"]
}
}
}
```
macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows：`%APPDATA%\Claude\claude_desktop_config.json`
重启 Claude Desktop。所有 22 种工具都会出现在工具选择器中。
## 在 Cursor，Cline，Continue，Claude Code 上安装
请参阅 [agents.melis.ai/docs/install-mcp](https://agents.melis.ai/docs/install-mcp) 以获取每个客户端的设置。
---
## 示例：标准的 RAG 流水线
```typescript
// 所有 22 种工具都注册为 MCP 工具 — 您的代理像调用任何函数一样调用它们
const page = await callTool('scrapepay', { url: 'https://example.com/article' });
const md = await callTool('markdownopt', { html: page.content });
const vec = await callTool('embedpay', { input: md.markdown });
const stored = await callTool('memoryserve_write', {
agent_id: 'agent-1', content: md.markdown, vector: vec.embedding,
});
// 稍后 — 回忆并防止间接注入
const hits = await callTool('memoryserve_query', {
agent_id: 'agent-1', query: 'what did we learn about X?',
});
for (const chunk of hits.matches) {
const scrub = await callTool('memscrub', { content: chunk.content });
if (scrub.risk_level === 'safe') useChunk(chunk);
}
```
每 5k-token 页的总成本：~$0.017 USDC。详细演练： [agents.melis.ai/pipelines/rag](https://agents.melis.ai/pipelines/rag)。
---
## 资助钱包
x402 在 Base 上使用 USDC 结算（Coinbase L2）。两条路径：
- **Coinbase 钱包** — 购买 USDC，切换到 Base 网络，发送到您的代理钱包。
- **从以太坊主网桥接** — [bridge.base.org](https://bridge.base.org).
$1.00 的 USDC 涵盖 100 次 ScrapePay 调用，200 次 PromptGuard 调用，或一次完整的 RAG 流水线输入运行。
---
## 发现表面（适用于代理构建者和 AI 消费者）
| URL | 目的 |
|-----|---------|
| [agents.melis.ai/llms.txt](https://agents.melis.ai/llms.txt) | 简洁的 LLM 可读目录 |
| [agents.melis.ai/llms-full.txt](https://agents.melis.ai/llms-full.txt) | 完整的模式 + 组合配方 |
| [agents.melis.ai/openapi.json](https://agents.melis.ai/openapi.json) | 所有 22 个端点的 OpenAPI 3.1 规范 |
| [agents.melis.ai/ai-plugin.json](https://agents.melis.ai/ai-plugin.json) | ChatGPT 插件清单 |
| `https://<service>.melis.ai/.well-known/mcp.json` | 按服务提供的 MCP 发现 |
| [agents.melis.ai/agents-faq](https://agents.melis.ai/agents-faq) | 代理构建者 FAQ（与人类 FAQ 不同） |
---
## 比较
- [ScrapePay vs Firecrawl](https://agents.melis.ai/comparison/vs-firecrawl)
- [EmbedPay vs OpenAI Embeddings (direct)](https://agents.melis.ai/comparison/vs-openai-embeddings)
- [MemoryServe vs Pinecone](https://agents.melis.ai/comparison/vs-pinecone)
- [完整的替代文档](https://agents.melis.ai/docs/compare)
---
## 源代码和许可
- **MCP 包装器源代码**（此仓库）：MIT 许可。
- **服务代码**（22 种服务本身）：出于安全原因闭源。
- **站点内容**（agents.melis.ai 文档）：CC-BY-4.0 — 标注“melis x402 Tools”并附上指向 agents.melis.ai 的链接。
---
## 安全
发现漏洞？请参阅 [SECURITY.md](./SECURITY.md)。请发送电子邮件至 mizukaizen@proton.me。 критические 问题在 24 小时内确认。
---
## 引用此作品
如果您在研究或下游产品中使用 melis x402 Tools，请参阅 [CITATION.cff](./CITATION.cff) 以获取规范的引用。
---
## 作者
[mizukaizen](https://melis.ai) — 代理操作员和构建者。
目录： [agents.melis.ai](https://agents.melis.ai) · 电子邮件：mizukaizen@proton.me
