bitcoin-mcp

基本能力

产品定位

bitcoin-mcp 是一个专注于比特币区块链数据查询和分析的工具，旨在为 AI 代理和开发者提供实时、准确的比特币区块链数据访问能力。

核心功能

• 查询实时比特币区块链信息（通过 bitcoin-cli，但不包含钱包功能）
• 访问内存池、区块和交易数据
• 基于交易输出值和 BitFeed 表示生成自定义的 BTC 区块 3D 可视化

适用场景

• 比特币区块链数据分析
• 交易费用和历史查询
• 区块和交易详细信息获取
• 网络状态和难度调整分析
• 3D 区块可视化生成

工具列表

Blockchain Information

• 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 表示

Transaction Information

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

Analytics

• get_difficulty_history: 获取难度调整历史
• get_fee_history: 获取交易费用历史
• get_hashrate_estimate: 估算网络哈希率
• get_block_time_distribution: 分析区块时间分布
• analyze_blockchain: 全面的区块链分析

Configuration

• configure_bitcoin_cli: 配置 bitcoin-cli 设置
• get_config_info: 获取当前服务器配置
• update_server_config: 更新服务器配置

常见问题解答

• 该服务不包含钱包功能，仅提供区块链数据的只读访问。
• 服务器默认仅绑定到本地主机（127.0.0.1）。

使用教程

使用依赖

• Claude Desktop（或其他 mcp 客户端）
• Python 3.10+
• Bitcoin 全节点（带有 bitcoin-cli）
• (Windows)

安装教程

1. 将仓库克隆到您的比特币全节点机器上（bitcoin-mcp 工作需要）

2. 安装依赖：

pip install -r requirements.txt

1. 确保 Bitcoin Core 是最新版本并正在运行。配置 .env 并添加 BITCOIN_CLI_PATH，以便 MCP 服务器可以找到 bitcoin-cli

2. 在 .env 中添加以下行：BITCOIN_CLI_PATH=C:\\Program Files\\Bitcoin\\daemon\\bitcoin-cli

3. Claude Desktop 配置（任何 mcp 服务器的标准设置）

4. 将 path\\to\\ 更新为您本地的 bitcoin-mcp 文件夹路径

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

调试方式

测试服务器是否加载了您的比特币全节点：

python bitcoin_mcp_server.py

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。