Maximumsats MCP

🚀 最大聪（Maximum Sats）MCP 服务器

最大聪 MCP 服务器用于比特币 AI 工具和 Nostr 信任网络评分。通过闪电网络 L402 实现按使用付费。

🚀 快速开始

随着 MCP 服务器的不断增加，一个关键问题随之而来：如何以去中心化的方式确保 MCP API 访问的安全并实现盈利？ 最大聪 MCP 服务器给出了答案。

✨ 主要特性

• L402 支付端点 — 每个 API 调用都可以要求以聪为单位进行支付。
• 信任网络（WoT）评分 — 为 Nostr 用户提供抗女巫攻击的声誉评分。
• Nostr ID 实用工具 — 支持解码/编码 npub、note、nprofile、nevent、naddr 等。

📦 安装指南

使用 npx 安装

npx maximumsats-mcp

添加到 MCP 客户端配置

{
  "mcpServers": {
    "maximumsats": {
      "command": "npx",
      "args": ["maximumsats-mcp"]
    }
  }
}

💻 使用示例

基础用法

获取用户声誉分数

curl -s "https://wot.klabo.world/score/npub1..." | jq '.score'
# 返回: {"score": 42, "rank": 1234, "percentile": 95.5}

解码闪电发票

curl -X POST "https://maximumsats.com/api/bolt11-decode" \
  -H "Content-Type: application/json" \
  -d '{"invoice":"lnbc..."}'
# 返回: amount, description_hash, expiry, payee pubkey

验证 Nostr 身份（NIP - 05）

curl -X POST "https://maximumsats.com/api/nip05-verify" \
  -H "Content-Type: application/json" \
  -d '{"identifier":"bob@nostr.com"}'
# 返回: pubkey, valid boolean, relay hints

高级用法

付费 API 访问流程

# 步骤 1: 请求（返回 402 状态码和闪电发票）
curl -X POST "https://maximumsats.com/api/bolt11-decode" \
  -H "Content-Type: application/json" \
  -d '{"invoice":"lnbc1..."}'

# 响应: {"error":"Payment required","payment_request":"lnbc...","payment_hash":"abc123...","amount_sats":21}

# 步骤 2: 在闪电钱包中支付发票，然后使用 payment_hash 重试
curl -X POST "https://maximumsats.com/api/bolt11-decode" \
  -H "Content-Type: application/json" \
  -H "Authorization: abc123..." \
  -d '{"invoice":"lnbc1..."}'

# 响应: {"status":"success","data":{...}}

📚 详细文档

工具介绍

AI 工具（maximumsats.com）

信任网络（wot.klabo.world） — 每天 50 次免费使用

安全与治理特性

1. 付费 API 访问控制 — 一次支付，一次重试

每个端点都可以设置付费访问。L402 流程很简单：

# 请求返回 HTTP 402 状态码和闪电发票
curl -X POST https://maximumsats.com/api/dvm \
  -H "Content-Type: application/json" \
  -d '{"prompt":"hello"}'
# 返回: {"error":"Payment required","payment_request":"lnbc21...","payment_hash":"abc123","amount_sats":21}

# 在闪电钱包中支付发票，然后在 Authorization 头中携带 payment_hash 重试
curl -X POST https://maximumsats.com/api/dvm \
  -H "Content-Type: application/json" \
  -H "Authorization: abc123" \
  -d '{"prompt":"hello"}'
# 返回: {"status":"success","data":{...}}

2. 基于信任网络的抗女巫攻击

信任网络端点根据 Nostr 公钥在网络中的位置进行评分，这对于以下场景很有价值：

• 赏金平台防止虚假账户
• 需要抗女巫攻击的投票系统
• 声誉引擎

curl https://maximumsats.com/api/wot/npub1...
# 返回: {"score": 45, "rank": 1234, "percentile": 95.5}

3. 无中间人 — 直接闪电支付

• 在闪电网络上即时结算
• 无需订阅，按请求付费
• 匿名，无需 KYC

API 文档

• maximumsats.com/stats — AI 工具定价
• wot.klabo.world/docs — 信任网络 API 交互式文档
• wot.klabo.world/openapi.json — OpenAPI 3.0 规范

🔧 技术细节

最大聪 MCP 服务器使用 L402 协议（闪电 HTTP 402）：

// 挑战响应包含发票
{ status: 402, error: "Payment required", invoice: "lnbc...", amount_sats: 21 }

// 支付后，重试时包含 payment_hash
{ status: 402, error: "Payment required", payment_hash: "abc123..." }

// 支付验证成功后的响应
{ status: 200, data: { ... } }

所有支付都通过闪电网络进行，不会造成区块链膨胀。

📄 许可证

本项目采用 MIT 许可证。