Bitcoin SV MCP Server

Bitcoin SV MCP Server

site icon
2025.04.19 8
TypeScript区块链服务加密货币工具AI集成金融服务
Bitcoin SV MCP Server 是一个基于 Model Context Protocol (MCP) 框架的比特币 SV (BSV) 工具集合,提供钱包、Ordinals(NFT)和实用功能,用于与 BSV 区块链交互。该服务器允许 AI 助手通过 MCP 协议调用 BSV 功能,支持多种 MCP 兼容客户端(如 Cursor 和 Claude for Desktop)。
View on GitHub

Overview

基本能力

产品定位

Bitcoin SV MCP Server 是一个为 AI 助手提供比特币 SV 区块链交互能力的工具集合,支持钱包操作、Ordinals(NFT)管理和区块链数据查询。

核心功能

  1. 钱包工具
  2. 获取公钥、创建签名、验证签名
  3. 加密/解密数据
  4. 获取 BSV 地址、发送 BSV/MNEE 代币
  5. 购买 NFT 或 BSV-20/BSV-21 代币
  6. 创建和铭刻 Ordinals

  7. BSV 工具

  8. 查询 BSV 价格
  9. 解码交易
  10. 区块链浏览器功能(通过 WhatsOnChain API)

  11. Ordinals 工具

  12. 获取铭文信息
  13. 搜索铭文
  14. 查询市场列表和销售记录
  15. 获取 BSV-20 代币详情

  16. 实用工具

  17. 数据格式转换(UTF-8、hex、base64、binary)

  18. MNEE 工具

  19. 查询 MNEE 代币余额
  20. 发送 MNEE 代币
  21. 解析 MNEE 交易

适用场景

  1. 通过 AI 助手管理 BSV 钱包
  2. 查询和交易 BSV 区块链上的 NFT 和代币
  3. 开发基于 BSV 区块链的 AI 应用
  4. 区块链数据分析和查询

使用教程

使用依赖

  1. 安装 Bun 运行时环境 bash curl -fsSL https://bun.sh/install | bash

安装教程

  1. 克隆仓库并安装依赖 bash git clone https://github.com/b-open-io/bsv-mcp.git cd bsv-mcp bun install

  2. 配置 MCP 客户端(以 Cursor 为例):

  3. 在 Cursor 设置中添加 MCP 服务器配置 json { "mcpServers": { "Bitcoin SV": { "command": "bunx", "args": ["bsv-mcp@latest"], "env": { "PRIVATE_KEY_WIF": "<your_private_key_wif>" } } } }

调试方式

  1. 运行服务器 bash bun run index.ts

  2. 查看日志

  3. Cursor: 在设置 → 扩展 → Model Context Protocol 中查看日志
  4. Claude for Desktop: bash tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

常见问题解答

  1. 连接问题
  2. 确保依赖已正确安装:bun install
  3. 验证 WIF 私钥是否正确设置
  4. 检查客户端是否支持 MCP 并正确配置

  5. 功能问题

  6. 查看客户端控制台输出中的错误信息
  7. 确保服务器正在运行

  8. 交易问题

  9. 确认钱包有足够余额
  10. 检查网络连接和区块链状态

许可证

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