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 許可證。