用途
Bitcoin Benji MCP 是一个 MCP（Model Context Protocol）服务器，接入 Bitcoin Benji API，为支持 MCP 的客户端提供比特币内存池情报和本地 AI 推理两类能力。它强调不使用第三方 API、不泄露数据，并通过闪电网络或链上稳定币完成按次付费。
主要能力
内存池情报（来自真实的 Bitcoin Core 全节点）：
- get_fees — 手续费估算与趋势
- get_whales — 鲸鱼/整合提醒
- get_mempool_state — 实时内存池状态
- get_mempool_history — 24 小时滚动快照
- predict_fees — 基于 EMA 的预测
- get_recent_blocks — 最近区块
- tx_status — 查询任意 txid
- fee_quote — 计划交易的精确费用
AI 推理（专用 GPU 上的 Qwen3，无第三方 API）：
- ai_summarize、ai_sentiment、ai_translate、ai_grammar
- ai_code_review、ai_code_generate、ai_extract、ai_classify
- ai_rewrite、ai_explain、ai_agent、ai_scrape
- ai_embed、ai_vision、ai_ocr、ai_transcribe_table
- ai_longform（约 5 万字文档固定费用）、ai_research（多步骤并带引用）
使用方式
在 Claude Desktop 中使用：编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows），重启 Claude。然后可以问“当前比特币手续费是多少？”——Claude 会调用 get_fees，遇到 402 挑战，返回 Lightning 发票；用任意钱包支付，把 preimage 粘贴回去，Claude 即完成调用。
在 Cursor / Cline / Continue / Windsurf 中使用：原理相同，将支持 MCP 的客户端指向 bitcoinbenji-mcp 二进制文件即可。
跳过手动支付循环——使用 API 密钥：预充值一次密钥，之后每次调用在后台自动扣费。也可在 Claude Desktop 配置中使用。
支付方式：双支付轨道——Lightning sats（L402）或 Base 上的 USDC（x402），支持自动支付。v0.2 新增 x402 自动支付：将 X402_PRIVATE_KEY 设置为持有 Base 上 USDC 的 EVM 私钥，每次工具调用会自动完成支付——无需 Lightning 钱包、无需 API 密钥、无需手动步骤。服务器会为每个 402 挑战签署 EIP-3009 USDC 授权并重试；gas 由 facilitator 赞助，资金直接进入卖方。
适用场景
- 需要在 MCP 客户端（如 Claude Desktop、Cursor、Cline、Continue、Windsurf）中获得比特币手续费、内存池、鲸鱼动态和交易状态查询。
- 需要本地/主权 AI 推理，包括文本处理、代码相关任务、抽取分类、OCR、视觉、嵌入和长文研究，同时避免提示词泄露给第三方 AI 服务。
限制
- 所有 26 个工具均为付费工具，单次调用 2–100 sats（或等值 USDC，10 sats = $0.01）；需通过 Lightning 或 Base 上的 USDC 支付。
- 需要支持 MCP 的客户端。
- 使用手动支付流程时需在 402 挑战后支付发票并回传 preimage；使用 x402 自动支付需配置持有 USDC 的 EVM 私钥；使用 API 密钥需预充值。
- 官方文本说明其运行在主权太阳能供电的 AMD Strix Halo 机器上，未提供其他部署与性能细节。
- 价格页面请见 api.bitcoinbenji.com/pricing；本文未提供的内容暂未提供。
