Bitcoin SV MCP Server

比特币SV MCP服务器

⚠️ 注意：实验工作正在进行中
该项目处于早期实验阶段。功能可能会发生变化，API 也尚未稳定。欢迎贡献代码、提供反馈和报告错误！欢迎随时提交问题或拉取请求。

适用于模型上下文协议 (MCP) 框架的比特币 SV (BSV) 工具集合。该库提供用于 BSV 区块链交互的钱包、序数函数和实用函数。

安装和设置

使用发髻（可选但推荐）

该项目使用Bun构建，Bun 是一个快速的 JavaScript 运行时和包管理器。虽然建议使用 Bun 以获得最佳性能，但该服务器也可以使用 Node.js 和 npm 运行，因为 Bun 的设计与 Node.js 向后兼容。

安装 Bun

macOS（使用 Homebrew）：

macOS/Linux/WSL（使用安装程序脚本）：

Windows： Windows 用户应该使用 WSL（Windows Subsystem for Linux）或 Docker 来运行 Bun。

Node.js 和 npm 也可以工作，但可能无法提供相同的性能优势。

连接到 MCP 客户端

该服务器实现了模型上下文协议(MCP)，允许人工智能助手使用比特币 SV 的功能。您可以将此服务器连接到各种兼容 MCP 的客户端。

注意： PRIVATE_KEY_WIF环境变量现在是可选的。如果没有它，服务器将以受限模式运行，仅提供教育资源和非钱包工具。钱包和 MNEE 代币操作需要有效的私钥。您还可以设置IDENTITY_KEY_WIF环境变量，以启用 sigma-protocol 对序数铭文进行签名，用于身份验证、策展和信任网络。

光标

要将 BSV MCP 服务器与Cursor一起使用：

1. 如果尚未安装 Cursor，请安装
2. 打开 Cursor 并导航至“设置”→“扩展”→“模型上下文协议”
3. 点击“添加新的全局 MCP 服务器”
4. 以 JSON 格式输入以下配置：

5. 将<your_private_key_wif>替换为您的实际私钥 WIF（请务必妥善保管！）。如果您没有，可以暂时不填写，但您将无法使用需要钱包的工具。 <your_identity_key_wif>也是可选的。它将使用提供的身份密钥通过 Sigma 协议对 1Sat Ordinals 进行签名。
6. 点击“保存”

BSV 工具现在将在“比特币 SV”命名空间下供 Cursor 的 AI 助手使用。

npm 用户的替代方案

如果您更喜欢使用 npm 而不是 Bun：

克劳德桌面版

要将此服务器连接到 Claude for Desktop：

1. 打开Claude for Desktop并转到 Claude > 设置 > 开发者
2. 单击“编辑配置”。

用你喜欢的文本编辑器打开 Claude 配置 json 文件。如果你更喜欢使用命令行方式：

3. 将 BSV MCP 服务器添加到您的配置中：
   { "mcpServers": { "Bitcoin SV": { "command": "bun", "args": [ "run", "bsv-mcp@latest" ], "env": { "PRIVATE_KEY_WIF": "<your_private_key_wif>", "IDENTITY_KEY_WIF": "<your_identity_key_wif>" } } } }
4. 将<your_private_key_wif>替换为你的实际私钥 WIF
5. 保存文件并重新启动 Claude for Desktop
6. 单击 Claude 桌面版中的工具图标（锤子）时，BSV 工具将会出现

npm 用户的替代方案 (Claude)

如果您更喜欢使用 npm 而不是 Bun，请将“命令”字段替换为“npx”。

可用工具

该工具包分为几类：

钱包工具

钱包工具提供核心 BSV 钱包功能：

BSV 工具

与 BSV 区块链和网络交互的工具：

序数工具

在 BSV 上使用序数 (NFT) 的工具：

实用工具

通用实用功能：

MNEE 工具

使用 MNEE 代币的工具：

使用 MCP 工具

连接后，您可以通过人工智能助手使用自然语言与比特币 SV 进行交互。以下是一些示例提示：

钱包操作

• “获取我的比特币SV地址”
• “发送 0.01 BSV 到 1ExampleBsvAddressXXXXXXXXXXXXXXXXX”
• “将价值 5 美元的 BSV 发送至 1ExampleBsvAddressXXXXXXXXXXXXXXXXX”
• “向 1ExampleBsvAddressXXXXXXXXXXXXXXXXX 发送 0.01 MNEE”
• “检查我的 MNEE 余额”
• “解析此 MNEE 交易：txid”
• “使用我的钱包密钥加密此消息”
• “解密之前为我加密的数据”
• “购买此 NFT 列表：txid_vout”
• “购买此 BSV-20 代币列表：txid_vout”

序数（NFT）

• “显示有关输出点为 6a89047af2cfac96da17d51ae8eb62c5f1d982be2bc4ba0d0cd2084b7ffed325_0 的 NFT 的信息”
• “搜索 Pixel Zoide NFT”
• “显示 BSV NFT 的当前市场列表”
• “显示代码为 PEPE 的 BSV-20 代币列表”
• “获取最近的 BSV-20 代币销售信息”

区块链操作

• “BSV 目前的价格是多少？”
• “解码此 BSV 交易：（交易十六进制或 ID）”
• “获取最新的比特币SV链信息”
• “显示高度 800000 的区块详细信息”
• “探索地址 1ExampleBsvAddressXXXX 的交易历史记录”
• “检查我的钱包地址中的未使用输出（UTXO）”
• “获取哈希 a1b2c3d4e5f6 的交易详细信息...”

数据转换

• “将‘Hello World’从 UTF-8 格式转换为十六进制格式”

MCP 提示和资源

BSV MCP 服务器提供专门的提示和资源，提供有关比特币 SV 技术的详细信息和背景。人工智能模型可以访问这些信息，以增强其理解力和能力。

可用提示

服务器提供以下教育提示，可通过 MCP 协议直接访问：

序数词提示

• 标识符： bitcoin_sv_ordinals
• 描述：有关比特币 SV 序数的全面信息，包括它们是什么、如何工作以及如何使用它们。
• 使用方法：向助手询问“比特币 SV 序数”或“1Sat 序数”以获取此信息。

BSV SDK提示

提供有关 Bitcoin SV SDK 详细信息的提示集合：

• 概述
  • 标识符： bitcoin_sv_sdk_overview
  • 描述：Bitcoin SV SDK 的概述，包括其用途和主要组件。
  • 用法：“告诉我有关 BSV SDK 的信息”或“什么是比特币 SV SDK？”
• 钱包操作
  • 标识符： bitcoin_sv_sdk_wallet
  • 描述：有关 BSV SDK 中的钱包操作的信息。
  • 用法：“钱包操作如何在 BSV SDK 中工作？”
• 交易大楼
  • 标识符： bitcoin_sv_sdk_transaction
  • 描述：有关交易创建和操作的详细信息。
  • 用法：“解释 BSV SDK 交易构建”或“如何使用 BSV SDK 创建交易？”
• 验证
  • 标识符： bitcoin_sv_sdk_auth
  • 描述：BSV SDK 中的身份验证和身份协议。
  • 用法：“BSV SDK 如何使用身份验证？”
• 密码学
  • 标识符： bitcoin_sv_sdk_cryptography
  • 描述：签名、加密和验证功能。
  • 用法：“解释 BSV SDK 加密功能”
• 脚本
  • 标识符： bitcoin_sv_sdk_script
  • 描述：比特币脚本和合约功能。
  • 用法：“如何使用 BSV SDK 处理比特币脚本？”
• 原语
  • 标识符： bitcoin_sv_sdk_primitives
  • 描述：BSV SDK 中的核心数据类型和结构。
  • 用法：“BSV SDK 中有哪些原语可用？”

可用资源

该服务器还提供对比特币征求意见稿（BRC）规范和文档的访问：

变更日志资源

• 标识符： bsv-mcp-changelog
• 描述：BSV MCP 服务器的版本历史和更新日志。
• 用法：“向我展示 BSV MCP 更新日志”或“最新版本有什么新内容？”

BRC 资源

• BRC 概览
  • 标识符： brcs_readme
  • 描述：BRC 存储库中所有 Bitcoin SV 协议规范的概述。
  • 用法：“向我展示比特币 SV BRC 概览”
• BRC 摘要
  • 标识符： brcs_summary
  • 描述：所有比特币 SV BRC 的目录。
  • 用途：“请给我一份比特币 SV BRC 的摘要”
• 具体的BRC规范
  • 标识符： brc_spec
  • 描述：按类别和编号访问特定的 BRC 规范。
  • 用法：“向我展示交易信封上的 BRC 8”或“BRC 1 指定什么？”

BRC类别

BRC 规范分为以下类别：

• 钱包
• 交易
• 脚本
• 代币
• 叠加层
• 付款
• 点对点
• 密钥派生
• 出站点
• 观点
• 状态机
• 应用程序

使用提示和资源

AI 模型可以利用这些提示和资源，提供关于比特币 SV 技术的更准确、更详细的答案。作为用户，您可以：

1. 询问特定主题：“告诉我有关比特币 SV 序数的信息”或“解释 BSV SDK 交易构建”
2. 请求具体的 BRC 详细信息：“BRC 8 指定了什么？”或“向我显示交易创建时的 BRC”
3. 获取概述：“什么是 BSV SDK？”或“显示所有 BRC 的摘要”

这些提示和资源增强了人工智能的知识库，即使对于复杂的比特币 SV 主题也能做出更技术性和更准确的反应。

MCP 的工作原理

当您与支持 MCP 的 AI 助手互动时：

1. 人工智能会分析你的请求并决定使用哪些工具
2. 经您批准后，它会调用适当的 BSV MCP 工具
3. 服务器在 Bitcoin SV 区块链上执行请求的操作
4. 结果返回给AI助手
5. 助手以自然、对话的方式呈现信息

自定义选项

可以使用环境变量定制 BSV MCP 服务器以启用或禁用特定组件：

组件配置

特定工具配置

示例

仅使用教育资源和提示运行，无需工具：

仅使用 BSV 工具运行，没有钱包或其他功能：

使用除钱包操作之外的所有工具：

创建交易但不广播它们（试运行模式）：

故障排除

如果您在使用 BSV MCP 服务器时遇到问题：

连接问题

1. 确保你的系统上安装了 Bun 或 Node.js
2. 验证您的 WIF 私钥是否在环境中正确设置
3. 检查您的客户端是否支持 MCP 并且已正确配置
4. 在客户端的控制台输出中查找错误消息

保持 Bun 最新状态

保持 Bun 更新到最新版本以确保兼容性非常重要：

要验证您当前的 Bun 版本：

日志记录和调试

对于 Claude for Desktop，请检查以下日志：

对于 Cursor，请检查设置 → 扩展 → 模型上下文协议中的 Cursor MCP 日志。

最近更新

• 交易广播控制：添加了DISABLE_BROADCASTING环境变量，以防止交易被广播到网络
• 区块链浏览器：添加了bsv_explore工具，用于访问 WhatsOnChain API 并支持主网/测试网
• 统一工具：将wallet_encrypt / wallet_decrypt合并为单个wallet_encryption工具
• 增强市场：支持 NFT、BSV-20/21 代币的上架、销售和购买
• 性能：添加价格缓存并优化 API 端点结构
• 改进的验证：更好地处理私钥和参数的错误

比特币SV区块链浏览器

bsv_explore工具通过 WhatsOnChain API 提供对比特币 SV 区块链的全面访问。这款强大的浏览器工具允许您查询区块链的各个方面，包括链数据、区块、交易和地址信息。

可用端点

该工具支持以下端点类别和特定端点：

链数据

区块数据

统计数据

交易数据

地址数据

网络

使用示例

bsv_explore工具可以与自然语言提示一起使用，例如：

在底层，该工具接受参数来指定要检索的数据：

• endpoint ：要查询的特定 WhatsOnChain 端点（例如， chain_info ， tx_by_hash ）
• network ：要使用的 BSV 网络（ main或test网络）
• 特定端点所需的附加参数：
  • blockHash ：用于 block_by_hash 和 block_pages 端点
  • blockHeight ：用于 block_by_height、tag_count_by_height 和 block_stats_by_height 端点
  • pageNumber ：用于 block_pages 端点（分页）
  • days ：对于 block_miner_stats 和 miner_summary_stats 端点（默认为 7）
  • txHash ：用于与交易相关的端点（tx_by_hash、tx_raw、tx_receipt）
  • txids ：用于 bulk_tx_details 端点（交易 ID 数组）
  • address ：用于与地址相关的端点
  • limit ：address_history 的可选分页限制

网络选项

该工具支持主网和测试网：

• main ：比特币 SV 主网（默认）
• test ：比特币SV测试网

发展

项目设置

如果您想为该项目做出贡献或在本地运行它：

1. 克隆存储库：
   git clone https://github.com/b-open-io/bsv-mcp.git cd bsv-mcp
2. 安装依赖项：
   bun install # or with npm npm install

运行服务器

运行测试

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。