使用说明

项目简介

bitcoin-mcp 是一个精简的 MCP 服务器，它允许 Claude Desktop 或其他兼容 MCP 协议的客户端访问 Bitcoin 区块链数据。该服务器通过 'bitcoin-cli' 与本地运行的 Bitcoin Core (完整节点) 交互，提供实时的区块链信息查询功能，但不包含任何钱包功能，确保数据访问的安全性。

主要功能点

实时 Bitcoin 区块链数据访问: 通过 'bitcoin-cli' 接口，提供最新的 Bitcoin 区块链信息，包括区块、交易、mempool 等数据。
丰富的工具集: 提供一系列预定义的工具，用于查询区块链状态、区块信息、交易信息、网络信息以及进行数据分析。
3D 可视化: 支持基于 BitFeed 表示的区块 3D 可视化生成，便于更直观地理解区块结构。
只读访问: 所有功能均为只读操作，不会进行任何钱包操作，保障 Bitcoin 资产安全。

安装步骤

克隆仓库: 将 'bitcoin-mcp' 仓库克隆到您的 Bitcoin 完整节点机器上 (服务器需要能够访问 'bitcoin-cli')。

git clone https://github.com/runeape-sats/bitcoin-mcp
cd bitcoin-mcp

安装依赖: 安装 Python 依赖库。

pip install fastmcp asyncio configparser

配置 Bitcoin Core 路径:
- 确保 Bitcoin Core 完整节点已运行并同步完成。
- 创建或编辑 '.env' 文件，添加 'BITCOIN_CLI_PATH' 环境变量，指向 'bitcoin-cli' 可执行文件的路径。例如在 Windows 系统上：
```
BITCOIN_CLI_PATH=C:\\Program Files\\Bitcoin\\daemon\\bitcoin-cli
```
  请根据您的 Bitcoin Core 安装路径进行调整。
Claude Desktop 配置: (或其他 MCP 客户端)
- 打开 Claude Desktop 的 MCP 服务器配置 (通常在设置或偏好设置中)。
- 添加一个新的 MCP 服务器配置，配置内容如下，请将 'path\to\' 替换为 'bitcoin-mcp' 仓库在您本地的实际路径。
```
{
  "mcpServers": {
    "bitcoin-mcp": {
      "command": "python",
      "args": ["path\\to\\bitcoin-mcp\\bitcoin_mcp_server.py"],
      "env": {}
    }
  }
}
```
配置参数说明:
- '"bitcoin-mcp"': 服务器名称，可以自定义，用于在 Claude Desktop 中标识该服务器。
- '"command": "python"': 启动服务器的命令，这里使用 'python' 解释器。
- '"args": ["path\to\bitcoin-mcp\bitcoin_mcp_server.py"]': 启动命令的参数，指定服务器主程序 'bitcoin_mcp_server.py' 的路径。请务必将 'path\to\bitcoin-mcp' 替换为实际路径。
- '"env": {}': 环境变量，这里为空，表示使用当前系统的环境变量。

基本使用方法

启动 MCP 服务器: 在 'bitcoin-mcp' 仓库目录下，运行以下命令启动服务器。
```
python bitcoin_mcp_server.py
```
服务器成功启动后，会显示连接 Bitcoin Core 的信息。
在 Claude Desktop 中使用:
- 确保 Claude Desktop 已正确配置并连接到 'bitcoin-mcp' 服务器。
- 在 Claude Desktop 中，可以使用自然语言指令调用 'bitcoin-mcp' 提供的工具来查询 Bitcoin 区块链信息。
示例指令:
- 查询当前区块链信息: 'Tell me about the current state of the Bitcoin blockchain'
- 查询特定区块信息 (例如区块高度 800000): '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 可视化 (例如区块高度 111111): 'Build a react threejs viewer for btc block 111111' (注意部分交易数量过多的区块可能导致上下文长度超出限制)
您可以参考 'README.md' 文件中 "Example Usage" 部分获取更多使用示例。

关键词

使用说明

项目简介

主要功能点

安装步骤

基本使用方法

信息