Bitcoin SV MCP Server

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

一个用于模型上下文协议（MCP）框架的Bitcoin SV（BSV）工具集合。此库提供了与BSV区块链交互的钱包、序数和实用函数。

安装选项

选项1：托管版本（免费 - 不需要BSV！）

最简单的开始方式！ 使用我们的托管版本并采用OAuth 2.1身份验证：

1. 配置： 将MCP服务器配置添加到您的IDE
2. 认证： 通过sigma-auth使用您的比特币钱包登录
3. 使用： 立即开始使用BSV功能 - 不需要BSV！

{
  "mcpServers": {
    "bsv-mcp-hosted": {
      "url": "https://bsv-mcp.rohenaz.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}

要获取访问令牌，请在 https://auth.sigmaidentity.com 进行身份验证。

优点：

• ✅ 不需要比特币 - 我们支付一切费用
• ✅ 使用比特币签名的安全OAuth 2.1身份验证
• ✅ 即时设置 - 不需要安装
• ✅ 始终保持最新
• ✅ 通过Cloudflare实现全球可用性

选项2：自托管安装

先决条件

使用Bun（可选但推荐）

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

安装Bun

macOS（使用Homebrew）：

brew install oven-sh/bun/bun

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

curl -fsSL https://bun.sh/install | bash

Windows： Windows用户应使用WSL（Linux子系统）或Docker来运行Bun。

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

连接到MCP客户端

此服务器实现了模型上下文协议（MCP），允许AI助手利用Bitcoin SV功能。您可以将此服务器连接到各种兼容MCP的客户端。

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

Claude Code

要使用BSV MCP服务器与Claude Code：

# 使用bunx（推荐）
claude mcp add bsv-mcp "bunx bsv-mcp@latest"

# 或使用npx
claude mcp add bsv-mcp "npx bsv-mcp@latest"

要使用环境变量添加：

claude mcp add bsv-mcp "bunx bsv-mcp@latest" -e PRIVATE_KEY_WIF=your_key -e IDENTITY_KEY_WIF=your_identity_key

对于加密密钥存储（推荐）：

claude mcp add bsv-mcp "bunx bsv-mcp@latest" -e BSV_MCP_PASSPHRASE="your-secure-passphrase"

注意： 当与Claude Code CLI一起使用时，服务器会自动运行在stdio模式下。

Cursor

快速安装： 点击上面的按钮即可自动将BSV MCP服务器添加到Cursor！这将使用bunx bsv-mcp@latest的基本配置安装服务器。

手动设置： 要手动配置BSV MCP服务器与Cursor：

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

{
  "mcpServers": {
    "Bitcoin SV": {
      "command": "bunx",
      "args": [
        "bsv-mcp@latest"
      ],
      "env": {
        "PRIVATE_KEY_WIF": "<your_private_key_wif>",
        "IDENTITY_KEY_WIF": "<your_identity_key_wif>"
      }
    }
  }
}

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

现在，BSV工具将在Cursor的AI助手下以“Bitcoin SV”命名空间提供。

npm用户的替代方案

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

{
  "mcpServers": {
    "Bitcoin SV": {
      "command": "npx",
      "args": [
        "bsv-mcp@latest"
      ],
      "env": {
        "PRIVATE_KEY_WIF": "<your_private_key_wif>",
        你的翻译内容到这里结束。