关键词

Bitcoin钱包管理比特币交易AI工具金融

项目简介

Bitcoin MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端应用，旨在为AI应用（如 Claude Desktop 和 Cursor）提供比特币相关的功能。通过此服务器，AI应用可以安全、可扩展地与比特币网络交互，管理钱包并进行交易。

主要功能点

  • 比特币钱包管理：支持创建和恢复比特币钱包，安全管理用户私钥。
  • 交易功能：支持发送比特币交易，查询钱包余额（链上和链下）。
  • 实时价格转换：提供实时比特币价格转换功能，方便用户了解比特币的法币价值。
  • 数据缓存优化：通过 blockchain.info 缓存优化价格数据获取，提高性能。
  • 强类型操作与Schema验证：使用 TypeScript 和 Zod 保证数据类型安全和请求参数的有效性。
  • 全面的错误处理：提供完善的错误处理和回退机制，增强系统健壮性。

安装步骤

  1. 安装 Node.js 和 pnpm：确保您的系统已安装 Node.js 和包管理器 pnpm。
  2. 克隆仓库：将 GitHub 仓库 'bitcoin-mcp' 克隆到本地。
  3. 安装依赖：在仓库根目录下运行命令 'pnpm install' 安装项目依赖。
  4. 构建项目：运行命令 'pnpm build' 构建项目，生成可执行的服务器代码。

服务器配置

MCP 服务器需要配置在 MCP 客户端中，以便客户端能够连接并使用其提供的功能。以下是 MCP 客户端所需的服务器配置信息（JSON 格式）：

{
  "serverName": "Bitcoin MCP Server",
  "command": "node",
  "args": ["dist/index.js"]
}

配置参数说明:

  • 'serverName': 服务器名称，可以自定义，用于在客户端中标识该服务器。例如 '"Bitcoin MCP Server"'。
  • 'command': 启动服务器的命令。由于本项目是 Node.js 应用，此处应为 '"node"'。
  • 'args': 启动命令的参数，以数组形式提供。对于本服务器，参数为构建后生成的服务器入口文件路径 '"dist/index.js"'。

注意: 请确保 MCP 客户端能够找到 'node' 命令，并且构建后的 'dist/index.js' 文件路径正确。

基本使用方法

  1. 启动服务器：无需手动启动服务器，MCP 客户端在需要时会自动根据配置启动 Bitcoin MCP Server。
  2. 在 MCP 客户端中使用工具：
    • 'setup_wallet': 用于创建或恢复比特币钱包。根据提示操作即可完成钱包初始化。
    • 'get_wallet_status': 获取当前钱包的初始化状态和网络信息。
    • 'get_addresses': 获取钱包的比特币接收地址，包括链上地址和链下地址（如闪电网络地址，如果支持）。
    • 'get_balance': 查询钱包余额，可以获取链上和链下的总余额，并可能提供法币价格参考。
    • 'send_bitcoin': 发送比特币到指定地址。需要提供接收地址和发送数量。

详细工具参数和使用方法请参考仓库 README.md 文件或工具的具体描述信息。

信息

分类

商业系统

访问项目