内容
# sats4ai-mcp
<a href="https://glama.ai/mcp/servers/@cnghockey/sats4ai">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@cnghockey/sats4ai/badge" />
</a>
**用于 AI 代理的无需许可的通信加速器。 40 多种工具通过比特币闪电网络支付。无需注册，无需 API 密钥，无需 KYC。**
一个远程 [MCP（模型上下文协议）](https://modelcontextprotocol.io/) 服务器，为 AI 代理提供访问任意语言的 AI 电话、602 种语言的语音、跨 119 种语言的翻译、传真、短信、转录、有声书、图像生成、音乐、文档提取等服务，所有服务均通过闪电网络微支付按次付费。
## 快速设置
### Claude 桌面版
将以下内容添加到您的 `claude_desktop_config.json` 文件中：
```json
{
"mcpServers": {
"sats4ai": {
"url": "https://sats4ai.com/api/mcp"
}
}
}
```
### Claude 代码
```bash
claude mcp add sats4ai --transport http https://sats4ai.com/api/mcp
```
验证连接：询问代理 *"列出前 3 个 Sats4AI 模型"* — 它应该调用 `list_models` 并返回结果。对于可以自主支付发票的代理，还需要添加一个闪电钱包 MCP（参见 [通过代理钱包支付](#通过代理钱包支付））。
### Cursor
设置 → MCP → 编辑配置，然后添加：
```json
{
"mcpServers": {
"sats4ai": {
"url": "https://sats4ai.com/api/mcp"
}
}
}
```
重启 Cursor。在新的聊天中，询问 *"有哪些 Sats4AI 工具可用？"* 以确认工具发现。对于自主支付，配对一个闪电钱包 MCP（参见 [通过代理钱包支付](#通过代理钱包支付））。
### Windsurf
编辑 `~/.codeium/windsurf/mcp_config.json`（如果不存在则创建）。**重要**：Windsurf 使用 `serverUrl`（不是 `url`）用于远程 HTTP MCP 服务器：
```json
{
"mcpServers": {
"sats4ai": {
"serverUrl": "https://sats4ai.com/api/mcp"
}
}
}
```
重启 Windsurf。Sats4AI 工具出现在 Cascade 工具列表中。Cascade 在所有 MCP 上有 100 个工具的上限，因此保持活动集精简。对于自主支付，配对一个闪电钱包 MCP（参见 [通过代理钱包支付](#通过代理钱包支付））。
### stdio 代理（旧版 MCP 客户端）
对于不支持远程 HTTP 服务器的客户端，使用捆绑的 stdio 代理：
```bash
npx sats4ai-mcp
```
或在您的配置中：
```json
{
"mcpServers": {
"sats4ai": {
"command": "npx",
"args": ["sats4ai-mcp"]
}
}
}
```
### 任意 MCP 客户端
服务器 URL 为：
```
https://sats4ai.com/api/mcp
```
这是一个远程 HTTP 服务器 — 无需本地进程，无需依赖，无需安装。
## 可用工具
### AI 生成
| 工具 | 描述 | 价格 |
|------|-------------|-------|
| `image` | 根据文本提示生成图像 | 100-200 sats |
| `video` | 根据文本提示生成视频 | 50 sats/unit |
| `video_from_image` | 将静态图像动画化为视频 | 100 sats/sec |
| `text` | 与 AI 语言模型聊天（262K 上下文） | ~1 sat/100 chars |
| `translate_text` | 跨 119 种语言翻译文本 | ~1 sat/1000 chars |
| `music` | 生成具有 AI 歌唱的歌曲 | 100 sats |
| `3d` | 将照片转换为 3D GLB 模型 | 350 sats |
### 音频与语音
| 工具 | 描述 | 价格 |
|------|-------------|-------|
| `tts` | 文本转语音（467 种语音，29 种语言） | 300 sats |
| `transcription` | 语音转文本（13 种语言） | 10 sats/min |
| `voice_clone` | 从音频样本克隆语音 | 7,500 sats |
| `epub_to_audiobook` | 将书籍（EPUB/PDF/TXT）转换为 AI 朗读的有声书 | 500+ sats |
### 图像处理
| 工具 | 描述 | 价格 |
|------|-------------|-------|
| `remove_background` | 从任何图像中删除背景（BiRefNet，SOTA） | 5 sats |
| `upscale_image` | 使用 Real-ESRGAN 将图像放大 2 倍/4 倍 | 5 sats |
| `restore_face` | 恢复模糊/损坏的脸（CodeFormer） | 5 sats |
| `colorize_image` | 将黑白照片上色（DDColor，ICCV 2023） | 5 sats |
| `deblur_image` | 删除相机抖动模糊（NAFNet，ECCV 2022） | 20 sats |
| `detect_nsfw` | 分类图像安全性（正常/建议/明确） | 2 sats |
| `detect_objects` | 使用边界框检测对象（Grounding DINO） | 5 sats |
| `remove_object` | 按描述删除对象 — 无需遮罩 | 15 sats |
| `image_edit` | 使用 AI 指令编辑图像 | 动态 |
### 视觉与文档
| 工具 | 描述 | 价格 |
|------|-------------|-------|
| `vision` | 分析和描述图像内容 | 21 sats |
| `ocr` | 从 PDF 和图像中提取文本 | 10 sats/page |
| `extract_receipt` | 收据转换为结构化 JSON | 50 sats |
| `file_convert` | 在 200+ 文件格式之间转换 | 100 sats |
| `pdf_merge` | 将多个 PDF 合并为一个 | 100 sats |
| `convert_html_to_pdf` | HTML/Markdown 转换为 PDF | 50 sats |
### 通信
| 工具 | 描述 | 价格 |
|------|-------------|-------|
| `send_email` | 向任何地址发送电子邮件 | 200 sats |
| `send_sms` | 全球发送短信 | 动态 |
| `place_call` | 拨打自动电话 | 动态 |
| `ai_call` | 发送 AI 语音代理进行双向通话 | 动态（~150-250 sats/call） |
| `send_fax` | 全球发送传真（PDF URL 或输入文本） | 500 sats（≤10 页），+50 sats/page 之后 |
| `receive_fax` | 打开 24 小时窗口接收传真，交付到电子邮件 | 500 sats (+200 OCR 附加组件) |
### 辅助工具
| 工具 | 描述 |
|------|-------------|
| `list_models` | 浏览可用的 AI 模型和定价 |
| `get_model_pricing` | 获取特定模型的定价 |
| `create_payment` | 为服务创建闪电发票 |
| `check_payment_status` | 检查是否收到付款 |
| `check_job_status` | 轮询异步作业（视频，3D，有声书） |
| `get_job_result` | 获取已完成的作业结果 |
| `request_refund` | 请求失败服务的退款 |
| `vote_on_service` | 为计划的服务投票 |
| `list_planned_services` | 查看即将推出的服务并投票 |
## 工作原理
1. **代理调用 `list_models`** 以发现可用的模型和定价
2. **代理调用 `create_payment`** — 获取闪电发票
3. **通过代理的闪电钱包（例如 [lightning-wallet-mcp](https://www.npmjs.com/package/lightning-wallet-mcp)）进行支付**
4. **代理调用工具（例如 `image`、`text`）并附上 `paymentId`**
5. **返回结果** — base64 图像、文本、URL 等
无需 API 密钥。无需账户。无需与身份绑定的速率限制。只有比特币和 AI。
## 错误处理与退款
当付费工具在支付后失败时，JSON-RPC 错误响应中包含退款信息：
```json
{
"jsonrpc": "2.0",
"id": 1,
"error": {
"code": -32603,
"message": "图像生成失败",
"data": {
"refund": {
"charge_id": 12345,
"refund_amount": 200,
"lnurl_withdraw": "lnurl1dp68gurn8ghj7..."
}
}
}
}
```
使用任何 LNURL 兼容的钱包或 `lightning-wallet` 中的 `claim_lnurl_withdraw` 工具领取退款。
## 通过代理钱包支付
与闪电钱包 MCP 服务器配对，以便您的代理可以自主支付：
```json
{
"mcpServers": {
"sats4ai": {
"url": "https://sats4ai.com/api/mcp"
},
"lightning-wallet": {
"command": "npx",
"args": ["lightning-wallet-mcp"]
}
}
}
```
代理使用 `lightning-wallet` 来支付来自 `sats4ai` 的发票，从而实现完全自主的 AI 工具使用。
## L402 API
用于直接 HTTP 集成的 L402 API，无需 MCP：
```bash
# 步骤 1：请求 -> 获取 402 + 闪电发票
curl -X POST https://sats4ai.com/api/l402/generate-image \
-H "Content-Type: application/json" \
-d '{"input": {"prompt": "a cat in space"}}' -i
# 步骤 2：使用任意闪电钱包支付发票
# 步骤 3：重新发送并附上证明
curl -X POST https://sats4ai.com/api/l402/generate-image \
-H "Content-Type: application/json" \
-H "Authorization: L402 <macaroon>:<preimage>" \
-d '{"input": {"prompt": "a cat in space"}}'
```
或者完全跳过手动步骤：我们的 L402 端点支持标准 L402 协议，因此 [**lnget**](https://github.com/lightninglabs/lnget) — Lightning Labs 自己的 L402 客户端 — 自动支付它们。将它指向您的闪电节点并调用端点：
```bash
lnget -X POST -d '{"text": "Hello", "targetLanguage": "Spanish"}' \
--content-type application/json --max-cost 50 \
https://sats4ai.com/api/l402/translate-text
# 获取 402，支付发票，重试，打印结果。
```
完整的 L402 文档： [sats4ai.com/l402](https://sats4ai.com/l402) | 代码示例： [sats4ai-l402-examples](https://github.com/cnghockey/sats4ai-l402-examples)
## 服务发现
用于代理发现的机器可读端点：
```bash
# 具有定价、质量基准和性能元数据的完整服务目录
GET https://sats4ai.com/.well-known/l402-services
# 具有延迟（p50/p95）、可靠性、故障模式的 MCP 工具目录
GET https://sats4ai.com/api/mcp/discovery
# 语义搜索 — 按功能查找工具
GET https://sats4ai.com/api/discover?q=translate
# 具有枚举和输入模式的服务元数据
GET https://sats4ai.com/api/l402/{service}
```
每个付费工具都包含 **性能元数据**（延迟 p50/p95、可靠性评级、已知故障模式），以便代理可以做出明智的决定，选择调用哪些工具以及等待多长时间。
## 程序化使用
```js
const { SERVER_URL, TOOLS, getClaudeConfig } = require("sats4ai-mcp");
console.log(SERVER_URL); // "https://sats4ai.com/api/mcp"
console.log(TOOLS); // ["image", "video", "text", ...]
console.log(getClaudeConfig()) // { mcpServers: { sats4ai: { url: "..." } } }
```
## 安全
发现漏洞？**不要公开问题。** 请发送电子邮件至 [sats4ai@gmail.com](mailto:sats4ai@gmail.com)。有关完整的披露政策和范围，请参见 [SECURITY.md](SECURITY.md)。
## 链接
- **网站**: [sats4ai.com](https://sats4ai.com)
- **MCP 文档**: [sats4ai.com/mcp](https://sats4ai.com/mcp)
- **L402 API 文档**: [sats4ai.com/l402](https://sats4ai.com/l402)
- **L402 代码示例**: [github.com/cnghockey/sats4ai-l402-examples](https://github.com/cnghockey/sats4ai-l402-examples)
- **服务发现**: [sats4ai.com/.well-known/l402-services](https://sats4ai.com/.well-known/l402-services)
- **语义搜索**: [sats4ai.com/api/discover](https://sats4ai.com/api/discover)
- **安全策略**: [SECURITY.md](SECURITY.md)
## 许可证
MIT
