内容
# 代理服务MCP服务器
**agentsvc.io MCP服务器** — 为AI代理提供20种按次付费的实用服务，支持[x402微支付协议](https://x402.org)。代理自动使用Base主网上的USDC支付 — 无需账户，无需API密钥，无需订阅。
## 这是什么
一个MCP服务器，暴露20种实用工具给任何MCP兼容的AI代理。每次工具调用费用为$0.001–$0.008 USDC，自动从代理的钱包支付。
## 可用工具（20种）
| 工具 | 费用 | 功能 |
|------|------|--------------|
| `ip_lookup` | $0.001 | IP地址 → 国家，城市，ISP，ASN，时区 |
| `dns_lookup` | $0.001 | 域名 → DNS记录（A，AAAA，MX，TXT，CNAME，NS） |
| `qr_code` | $0.001 | 文本/URL → 二维码（base64 PNG） |
| `exchange_rates` | $0.001 | 实时外汇汇率（ECB，30+种货币，每小时） |
| `email_validate` | $0.001 | 邮箱 → 格式 + MX + 可用性检查 |
| `ssl_check` | $0.001 | 域名SSL证书 → 发行者，到期时间，剩余天数 |
| `phone_validate` | $0.001 | 电话号码 → E.164格式，国家，线路类型 |
| `weather` | $0.002 | 城市/GPS → 当前天气 + 3天预报 |
| `translate` | $0.002 | 文本 → 翻译文本（100+种语言） |
| `whois` | $0.002 | 域名 → 注册商，创建/过期时间，域名服务器 |
| `crypto_prices` | $0.002 | 加密货币ID → 实时价格，市场总值，24小时变化 |
| `stock_prices` | $0.002 | 股票代码 → 价格，市盈率，52周范围 |
| `geocode` | $0.002 | 地址 → 经纬度或经纬度 → 地址 |
| `web_search` | $0.003 | 查询 → 事实总结 + 链接（DuckDuckGo + Wikipedia） |
| `news_search` | $0.003 | 查询 → 近期新闻文章（HackerNews + BBC） |
| `pdf_extract` | $0.004 | PDF（base64） →全文 + 每页分解 |
| `screenshot` | $0.005 | URL → PNG截图（base64，全JS渲染） |
| `webpage_reader` | $0.006 | URL → 清洁可读文本 + 标题 + 链接 |
| `html_to_pdf` | $0.008 | URL或HTML → PDF（base64） |
| `ocr` | $0.008 | 图片（base64） → 提取文本（40+种语言） |
## 安装
### 要求
- Node.js 18+
- `npm install viem x402` （用于支付签名）
- 一个带有Base主网USDC的钱包私钥
### 克劳德桌面
```bash
curl -O https://agentsvc.io/mcp-server.mjs
npm install viem x402
```
添加到`claude_desktop_config.json`：
```json
{
"mcpServers": {
"agentsvc": {
"command": "node",
"args": ["/path/to/mcp-server.mjs"],
"env": {
"X402_PRIVATE_KEY": "0x..."
}
}
}
}
```
### 任意MCP兼容代理
MCP服务器在启动时自动发现所有20种工具。工具动态加载 — 新服务自动出现，无需更新服务器。
## 支付方式
每次工具调用使用[x402协议](https://x402.org)：
1. 代理调用工具
2. 服务器探测服务（HTTP 402响应，支付要求）
3. MCP服务器使用私钥签署Base主网上的USDC支付
4. 服务执行并返回结果
支付**每次调用原子化** — 仅在调用成功时支付。钱包需要Base主网上的USDC。
**获取Base主网USDC：**
- 从以太坊桥接：[bridge.base.org](https://bridge.base.org)
- 在Coinbase购买 → 提现到Base
- 在Uniswap/Aerodrome（Base）兑换
## 成本示例
| 用例 | 每日成本 |
|-------|-----------|
| 100次调用/天（平均$0.003） | $0.30 |
| 1,000次调用/天 | $3.00 |
| 10,000次调用/天 | $30.00 |
## REST API
所有工具也作为直接REST API提供，无需MCP：
```bash
# 步骤1：探测（获取支付要求）
curl -X POST https://agentsvc.io/api/v1/proxy/ip-lookup \
-H "Content-Type: application/json" \
-d '{"ip": "8.8.8.8"}'
# → HTTP 402，包含accepts[]支付要求
# 步骤2：签名 + 重试，带有X-Payment头部
# 参见：https://agentsvc.io/docs
```
**端点：**
- `GET /api/v1/services` — 完整的目录，包含模式 + 价格
- `GET /api/openapi.json` — OpenAPI 3.1规范
- `GET /.well-known/agent-services.json` — 可读性强的清单
## 链接
- **实时：** [agentsvc.io](https://agentsvc.io)
- **MCP服务器下载：** [agentsvc.io/mcp-server.mjs](https://agentsvc.io/mcp-server.mjs)
- **服务目录：** [agentsvc.io/api/v1/services](https://agentsvc.io/api/v1/services)
- **OpenAPI规范：** [agentsvc.io/api/openapi.json](https://agentsvc.io/api/openapi.json)
- **代理清单：** [agentsvc.io/.well-known/agent-services.json](https://agentsvc.io/.well-known/agent-services.json)
- **文档：** [agentsvc.io/docs](https://agentsvc.io/docs)
## 支付详情
- **协议：** x402精确方案
- **网络：** Base主网（链ID：8453）
- **货币：** USDC
- **USDC合约：** `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
- **原子单位：** 1 USDC = 1,000,000单位
## 许可证
MIT
