AI导哈

比特币区块链数据服务

bitcoin-mcp是一个基于MCP协议的服务器实现，通过与Bitcoin Core（全节点）交互，为Claude Desktop等客户端提供比特币区块链数据的只读访问，支持查询区块、交易信息及生成3D可视化数据。

  • by runeape-sats
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 runeape-sats/bitcoin-mcp

使用说明

比特币mcp

bitcoin-mcp基于准确的比特币区块链数据扩展AI实用程序 主控程序.bitcoin mcp是一个简化的模型上下文协议（mcp）服务器实现，通过以下方式与比特币核心（全节点）连接 bitcoin-cli此比特币mcp服务器为Claude Desktop（或其他mcp客户端）提供比特币区块链数据的READ访问权限 没有钱包功能.

特性

AI代理遇到了最安全的数据分类账——比特币。

  • 查询实时比特币区块链信息（通过 bitcoin-cli，但没有任何钱包呼叫）

  • 访问内存池、块和事务数据

  • 基于TX输出值和BitFeed表示生成BTC块的自定义3D可视化（即 mempool.space)

先决条件

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

安装

  1. 将回购克隆到您最新的btc全节点机器上（比特币mcp工作所需）

  2. 安装依赖项：

pip install -r requirements.txt
  1. 确保Bitcoin Core是最新的并且正在运行。配置 .env 并添加 BITCOIN_CLI_PATH 以便MCP服务器能够找到 bitcoin-cli
  • 有这条线 BITCOIN_CLI_PATH=C:\\Program Files\\Bitcoin\\daemon\\bitcoin-cli 在……里面 .env
  1. Claude桌面配置（任何mcp服务器的标准设置）
  • 更新 path\\to\\ 到你当地 bitcoin-mcp 文件夹
{
  "mcpServers": {
    "bitcoin-mcp": {
      "command": "python",
      "args": ["path\\to\\bitcoin-mcp\\bitcoin_mcp_server.py"],
      "env": {}
    }
  }
}

测试服务器：

您可以测试python服务器，看看它是否加载了您的btc完整节点。

python bitcoin_mcp_server.py

可用工具

主要用于像Claude Desktop这样的mcp客户利用比特币区块链信息，因此不包括钱包功能。

区块链信息

工具 说明
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 基于TX数据获取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 配置比特币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服务器 不 在比特币核心中包含钱包功能（你可以自己添加）
  • 默认情况下，服务器只绑定到localhost（127.0.0.1）
  • 允许对区块链数据进行只读访问

示例用法

获取当前区块链信息：

Tell me about the current state of the Bitcoin blockchain

分析特定块：

Show me detailed information about block 800000

获取交易费用历史记录：

What have transaction fees been like over the past 24 hours?

估计哈希率：

What is the current estimated hashrate of the Bitcoin network?

生成3D表示（请注意，上下文长度可能不适合所有TX，请尝试TX编号<20的块）：

Build a react threejs viewer for btc block 111111

许可证

MIT许可证

相关 MCP