bitcoin-mcp

bitcoin-mcp 基于 MCP 扩展了AI工具，提供了准确的比特币区块链数据。bitcoin-mcp 是一个精简的模型上下文协议（MCP）服务器实现，通过 bitcoin-cli 与比特币核心（全节点）进行交互。此 bitcoin-mcp 服务器为 Claude Desktop（或其他 mcp 客户端）提供对比特币区块链数据的 只读访问权限，但不包括钱包功能。

功能

AI代理与最安全的数据账本——比特币相遇。

• 查询实时比特币区块链信息（通过 bitcoin-cli，但不涉及任何钱包调用）

• 访问内存池、区块和交易数据

• 根据交易输出值和 BitFeed 表示生成自定义的比特币区块 3D 视图（即 mempool.space 上那些美丽的矩形）

  

预备条件

• Claude Desktop（或其他 mcp 客户端）
• Python 3.10+
• 比特币全节点（带 bitcoin-cli）
• （Windows）

安装

1. 将仓库克隆到你的最新比特币全节点机器上（bitcoin-mcp 正常运行所必需）

2. 安装依赖项：

pip install -r requirements.txt

3. 确保比特币核心已更新并正在运行。配置 .env 并添加 BITCOIN_CLI_PATH，以便 MCP 服务器可以找到 bitcoin-cli

• 在 .env 文件中添加这一行 BITCOIN_CLI_PATH=C:\\Program Files\\Bitcoin\\daemon\\bitcoin-cli

4. Claude Desktop 配置（适用于任何 mcp 服务器的标准设置）

• 更新 path\\to\\ 到你的本地 bitcoin-mcp 文件夹

{
  "mcpServers": {
    "bitcoin-mcp": {
      "command": "python",
      "args": ["path\\to\\bitcoin-mcp\\bitcoin_mcp_server.py"],
      "env": {}
    }
  }
}

测试服务器：

你可以测试 Python 服务器，看看它是否加载了你的比特币全节点。

python bitcoin_mcp_server.py

可用工具

主要用于 mcp 客户端如 Claude Desktop 利用比特币区块链信息，因此不包括任何钱包功能。

区块链信息

工具	描述
get_blockchain_info	获取当前区块链状态
get_block_hash	获取特定高度的区块哈希
get_block	根据哈希获取区块数据
get_block_stats	获取区块统计数据
get_chain_tips	获取关于链尖的信息
get_chain_tx_stats	获取链交易统计数据
get_difficulty	获取当前难度
get_network_info	获取网络信息
get_blockchain_status	获取综合区块链状态
get_detailed_block_info	获取详细的区块信息
search_blocks	搜索符合标准的区块
get_bitfeed_3d_representation	根据交易数据获取 BTC 区块的 3D 表示

交易信息

工具	描述
get_mempool_info	获取内存池信息
get_tx_out	获取 UTXO 信息
get_tx_out_set_info	获取 UTXO 集统计信息
get_raw_transaction	获取原始交易数据
decode_raw_transaction	解码原始交易
estimate_smart_fee	估算交易费用
analyze_transaction	分析交易详情

分析

工具	描述
get_difficulty_history	获取难度调整历史
get_fee_history	获取交易费用历史
get_hashrate_estimate	估算网络算力
get_block_time_distribution	分析区块时间分布
analyze_blockchain	综合区块链分析

配置

工具	描述
configure_bitcoin_cli	配置 bitcoin-cli 设置
get_config_info	获取当前服务器配置
update_server_config	更新服务器配置

代码结构

• bitcoin_mcp_server.py: 主服务器入口点
• bitcoin_connection.py: 比特币核心连接工具
• bitcoin_config.py: 配置管理
• bitcoin_transactions.py: 交易分析工具
• bitcoin_utils.py: 区块链工具
• bitcoin_analytics.py: 高级区块链分析
• bitfeed.py: BTC 区块的 3D 表示

安全注意事项

• 该 mcp 服务器 不 包括比特币核心中的钱包功能（你可以自行添加这些功能）
• 默认情况下，服务器仅绑定到本地主机（127.0.0.1）
• 启用对区块链数据的只读访问权限

示例用法

获取当前区块链信息：

告诉我比特币区块链的当前状态

分析特定区块：

显示关于区块 800000 的详细信息

获取交易费用历史：

过去 24 小时内交易费用如何？

估算算力：

比特币网络当前的估算算力是多少？

生成 3D 表示（注意上下文长度可能不适合所有交易，尝试交易数量小于 20 的区块）：

为 BTC 区块 111111 构建一个 react threejs 查看器

许可证

MIT 许可证