使用说明

项目简介

Bitcoin MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在桥接大型语言模型 (LLM) 和比特币区块链。它允许 AI 模型通过标准化的 MCP 协议,安全地访问和操作比特币网络的相关信息和功能。

主要功能点

  • 密钥生成: 生成新的比特币密钥对,包括地址、公钥和私钥(WIF 格式)。
  • 地址验证: 验证比特币地址的有效性,支持主网和测试网地址。
  • 交易解码: 解析原始比特币交易的十六进制数据,并以人类可读的格式展示交易详情。
  • 区块链查询:
    • 最新区块: 获取比特币区块链上最新区块的详细信息,如哈希值、高度、时间戳和交易数量等。
    • 交易详情: 根据交易 ID (TXID) 查询特定交易的详细信息。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的系统中已安装 Node.js 和 npm。你可以从 Node.js 官网 下载并安装。
  2. 安装 Bitcoin MCP Server: 使用 npm 全局安装 'bitcoin-mcp' 包。
    npm install -g bitcoin-mcp
    或者使用 npx 直接运行,无需全局安装。

服务器配置

Bitcoin MCP Server 可以作为 MCP 服务器与 MCP 客户端(如 Claude Desktop 或 Goose)集成。以下是配置示例,你需要根据你使用的 MCP 客户端进行配置。

Claude Desktop 配置

打开 Claude Desktop 的配置文件 'claude_desktop_config.json'(不同操作系统路径不同,请参考仓库 README.md 中的指引),在 '"mcpServers"' 部分添加以下配置:

{
  "mcpServers": {
    "bitcoin-mcp": {
      "command": "npx",
      "args": ["-y", "bitcoin-mcp@latest"]
    }
  }
}
  • '"bitcoin-mcp"': 服务器的标识符,你可以自定义名称。
  • '"command": "npx"': 运行命令,这里使用 'npx'。
  • '"args": ["-y", "bitcoin-mcp@latest"]': 命令参数,'-y' 自动确认安装,'bitcoin-mcp@latest' 指定运行 'bitcoin-mcp' 包的最新版本。

Goose 配置

在 Goose 中添加扩展时,选择 Command-Line Extension,并填写以下信息:

  • Name: 例如 'bitcoin' (自定义名称)
  • Command: 'npx'
  • Arguments: '-y bitcoin-mcp@latest'

基本使用方法

配置完成后,在支持 MCP 协议的客户端(如 Claude Desktop 或 Goose)中,你可以直接向 AI 模型提出关于比特币的问题,例如:

  • "生成一个新的比特币地址"
  • "验证地址 '1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa' 是否有效"
  • "解码交易 '01000000010000000000000000000000000000000000000000000000000000000000000000ffffffff0704ffff001d0104ffffffff0100f2052a0100000043410496b538e853519c726a2c91e61ec11600ae1390813a627c66fb8be7947be63c52da7589379515d4e0a600081ecbbda97b9d8efefe55c70323de249055f3f9f2581ffffffff00000000"'
  • "获取最新的比特币区块信息"
  • "查询交易 ID 为 'TXID_HERE' 的交易详情" (将 'TXID_HERE' 替换为实际的交易 ID)

AI 模型将通过 Bitcoin MCP Server 调用相应的工具,并返回比特币网络的相关信息。

信息

分类

AI与计算