内容
# 工具快照 MCP
> 为 AI 代理提供高效的微工具。按调用次数付费，使用 Base 上的 USDC。
[](https://glama.ai/mcp/servers/icosaedro-git/toolsnap-mcp)
[](https://mcp.toolsnap.app/.well-known/mcp.json)
[](https://x402.org)
[](https://base.org)
[](https://workers.cloudflare.com)
**实时端点：** `https://mcp.toolsnap.app/mcp`
**服务器卡片：** [/.well-known/mcp.json](https://mcp.toolsnap.app/.well-known/mcp.json)
**定价：** [/.well-known/pricing.json](https://mcp.toolsnap.app/.well-known/pricing.json)
**文档：** [toolsnap.app/agents](https://toolsnap.app/agents)
---
## 为什么
AI 代理最大的成本不是生成，而是上下文。当代理加载原始网页以提取信息时，它可能会在 HTML 模板上消耗超过 50,000 个标记。ToolSnap MCP 将这项工作转移到服务器端。
**基准测试（11 个真实页面，2026 年 6 月）：**
| | 原始 HTML | 提取 | 节省 |
|---|---|---|---|
| 中位数标记 | 53,820 | 2,001 | **98.1%** |
| 成本（Sonnet，$3/M） | $0.162 | $0.006 | **$0.156/调用** |
|收支平衡页面大小 | — | — | 26 KB |
该工具的成本为 $0.02 USDC → 典型页面的投资回报率为 7.8 倍。
---
## 连接
### 克劳德桌面
```json
{
"mcpServers": {
"toolsnap": {
"url": "https://mcp.toolsnap.app/mcp",
"transport": "streamable-http"
}
}
}
```
免费工具立即与上述 URL 连接生效。**付费工具需要 x402 支付客户端** - 仅凭钱包不足以满足 `402 Payment Required` 的要求。使用下面的支付代理。
### 付费工具 - 通过支付代理连接
`scripts/pay-proxy.mjs` 是一个本地 stdio MCP 服务器，它包装远程端点，读取您的钱包，并自动签名和重试，当服务器要求支付时。私钥从未离开您的主机；仅发送签名。
```json
{
"mcpServers": {
"toolsnap": {
"command": "node",
"args": ["/ABSOLUTE/PATH/to/toolsnap-mcp/scripts/pay-proxy.mjs"]
}
}
}
```
还没有钱包？调用 `wallet_setup` 工具 - 它生成一个您控制的钱包，帮助您的用户使用 Base 上的 USDC 为其充值，并连接此代理。密钥解析顺序：`TOOLSNAP_WALLET_KEY` → `~/.toolsnap/wallet.key` → macOS 钥匙串（`toolsnap-agent-wallet/default`）。
有用环境：`TOOLSNAP_MAX_PRICE_USDC`（每次调用的支出上限，默认 `0.10`），`TOOLSNAP_PREPAID=1` + `TOOLSNAP_AUTO_DEPOSIT_USDC`（使用较便宜的预付余额）。
### 直接 MCP 调用
```bash
curl -X POST https://mcp.toolsnap.app/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```
---
## 工具
### 付费（x402）
| 工具 | 描述 | 价格 |
|---|---|---|
| `fetch_extract` | 获取 URL → 清洁文本。中位数标记减少 98.1%。 | $0.02 USDC |
**每个钱包地址的首次调用免费**。之后，您的代理使用 [x402 v2](https://x402.org) （EIP-3009 `transferWithAuthorization`）在 Base 上支付 $0.02 USDC。无需 API 密钥，无需订阅 - 仅在调用时付费。
### 免费（始终）
| 工具 | 描述 |
|---|---|
| `pricing` | 机器可读的定价菜单 + 投资回报率。首先调用此工具。 |
| `uuid_generate` | 1-100 个随机 UUID v4 值 |
| `hash_text` | SHA-256 / SHA-1 / SHA-512（十六进制） |
| `base64_encode` | UTF-8 → Base64 |
| `base64_decode` | Base64 → UTF-8 |
| `url_encode` | 百分比编码（encodeURIComponent） |
| `url_decode` | 解码百分比编码字符串 |
| `json_format` | 解析 + 美化或压缩 JSON |
| `timestamp_convert` | Unix ↔ ISO 8601（自动检测方向） |
| `text_stats` | 字符、单词、行、句子 |
---
## 支付（x402）
当代理调用 `fetch_extract` 且无支付时，服务器返回：
```json
{
"jsonrpc": "2.0",
"id": 1,
"error": {
"code": 402,
"message": "Payment required",
"data": {
"x402Version": 2,
"accepts": [{
"scheme": "exact",
"network": "eip155:8453",
"amount": "20000",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}]
}
}
}
```
启用 x402 的客户端读取 `accepts[0]`，签名 EIP-3009 `TransferWithAuthorization`，并重试，设置 `_meta["x402/payment"]`。参见 [x402 规范](https://github.com/coinbase/x402/blob/main/specs/x402-specification-v2.md)。
---
## 本地运行
```bash
npm install
cp .dev.vars.example .dev.vars # 填写钱包机密
npm run dev
# Worker 在 http://localhost:8787
```
## 类型检查
```bash
npm run typecheck
```
## 部署
```bash
npm run deploy
```
---
## 技术栈
- **运行时：** Cloudflare Workers（边缘，0 毫秒冷启动）
- **协议：** MCP streamable-http（JSON-RPC 2.0）
- **支付：** x402 v2 · EIP-3009 on Base 主网 · USDC
- **验证：** 离链 EIP-712 签名恢复（viem）
- **结算：** 通过中继钱包的链上 `transferWithAuthorization`
- **防重放：** Cloudflare KV 随机数存储（7 天 TTL）
- **首次免费：** KV 密钥 `first_free:{address}`，已验证但未结算
---
## 贡献
欢迎为 `src/tools/` 中的**新免费工具**提交 PR。遵循 [`src/tools/text-stats.ts`](src/tools/text-stats.ts) 中的模式，并将工具添加到 [`src/tools/index.ts`](src/tools/index.ts)。
对于付费工具或对 x402 支付逻辑的更改，请先打开一个问题。
**不要提交钱包私钥、`.dev.vars` 或任何机密信息。**
---
[](https://glama.ai/mcp/servers/icosaedro-git/toolsnap-mcp)
---
## 许可证
MIT
