用途
bitcoin-mcp 面向需要比特币能力的 AI 智能体，通过 Model Context Protocol（MCP）把比特币基础设施接入智能体工作流。它提供 50 个标准比特币工具、6 个提示词和 8 个资源，让智能体能够进行费用情报、内存池分析、区块与交易检查等操作。
主要能力
- 费用情报：判断最便宜的发送时机、比较费率层级、在广播前估算确切成本。例如智能体可调用 get_fee_recommendation 获得“立即发送或等待”的建议，并给出以 sat/vB 为单位的费率。
- 区块与交易：解码并分析交易、检查与比较区块。
- 网络与状态：提供网络和节点状态相关信息。
- 索引地址：需要区块链索引器支持。
- 可选远程 API：当设置了 SATOSHI_API_URL 且安装了 l402 额外依赖时，会注册 query_remote_api，用于查询显式配置端点上的规范 /api/v1 路由。
提示词与资源：内置 6 个常用工作流提示词（analyze_fee_environment、investigate_transaction、monitor_mempool_fees、taproot_adoption_report、network_health_report、track_transaction）和 8 个用于上下文注入的资源（如 bitcoin://connection/status、bitcoin://node/status、bitcoin://fees/current、bitcoin://fees/history、bitcoin://mempool/snapshot 以及协议相关资源）。
使用方式
项目需要比特币数据后端，会自动从本地 Bitcoin Core/Knots 节点的 cookie 或 RPC 设置中检测；没有本地节点时，需设置 SATOSHI_API_URL 指向兼容部署。它支持添加到 claude_desktop_config.json、.cursor/mcp.json、.vscode/mcp.json 以及 Zed 的 settings.json（在 context_servers 下），也可以用 docker compose 运行。
连接本地 Bitcoin Core 节点时，可通过环境变量传递配置：BITCOIN_RPC_HOST、BITCOIN_RPC_PORT 以及可选的凭据或 datadir；连接兼容远程 API 时使用 SATOSHI_API_URL，必要时使用 SATOSHI_API_KEY。项目还提供运行时标志。
一个典型激活路径是向智能体提出：“I need to send a Bitcoin transaction today. Use bitcoin-mcp to decide whether to send now or wait, and show the fee rate you used.” 智能体会调用 get_fee_recommendation，并返回明确的发送或等待建议及费率。如果后端不可用，需先配置本地节点或设置 SATOSHI_API_URL 再重试。
适用场景
适用于需要比特币工具的开发仓库和智能体集成场景，例如构建与比特币交互的 AI 智能体、进行费用分析和内存池监控、交易调查、区块分析等。examples/ 文件夹中提供了费用分析、内存池监控、交易调查、区块分析等使用模式示例。
限制与注意事项
- 项目需要可用的数据后端。如果本地节点和兼容远程 API 都不可用，bitcoin-mcp 会以设置错误退出连接检查，而不会静默选择一个不可用的公共服务。
- 原先托管在 bitcoinsapi.com 的公共 Satoshi API 已暂停，不应被视为可用的默认服务。
- 版本 0.5.2 包含 MCP SDK 1.x 兼容约束和显式后端选择；旧安装建议升级。
- bitcoin-mcp 是免费、开源的比特币基础设施，通过 GitHub Sponsors 等方式支持开发。
- 相关项目包括 Satoshi API（可自托管兼容后端）、ChainPulse、BAIP-1 和 bitcoin-fee-observatory。
