项目简介

Bitcoin SV MCP Server 是一个基于 Model Context Protocol (MCP) 框架构建的实验性服务器，它为大型语言模型（LLM）客户端提供了一系列 Bitcoin SV (BSV) 区块链相关的工具。通过这个服务器，AI 助手可以理解和操作 BSV 网络上的资源，例如管理钱包、处理 Ordinals NFT、查询区块链信息等。

请注意： 该项目目前处于早期实验阶段，功能和API可能会发生变化。

主要功能点

钱包工具 (Wallet Tools): 提供 BSV 钱包的核心功能，包括生成公钥、创建和验证签名、加密解密数据、获取地址、发送 BSV 交易、购买 Ordinals NFT 挂单等。
BSV 工具 (BSV Tools): 提供与 BSV 区块链和网络交互的功能，例如获取 BSV 价格、解码 BSV 交易等。
Ordinals 工具 (Ordinals Tools): 专注于 Ordinals NFT 的操作，包括查询铭文信息、搜索铭文、获取市场挂单、查询 BSV20 代币市场销售和信息等。
通用工具 (Utility Tools): 提供数据格式转换等通用功能。

安装步骤

安装依赖: 在项目根目录运行以下命令安装依赖：
```
bun install
```
或者使用 npm:
```
npm install
```

全局安装 (推荐): 为了方便 MCP 客户端集成，建议将 'bsv-mcp' 全局安装：

bun install -g bsv-mcp

或者使用 npm:

npm install -g bsv-mcp

服务器配置

MCP 客户端需要配置服务器的启动命令才能连接到 BSV MCP Server。以下是通用的 JSON 配置信息，您需要根据不同的 MCP 客户端进行配置。

通用配置 (JSON):

{
  "Bitcoin SV": {
    "command": "env",
    "args": [
      "PRIVATE_KEY_WIF=<your_private_key_wif>",
      "bunx",
      "bsv-mcp"
    ]
  }
}

参数说明:

'"Bitcoin SV"': 服务器名称，可以自定义。
'"command": "env"': 指定使用 'env' 命令来设置环境变量并执行后续命令。
'"args"': 参数列表，包含以下内容：
- '"PRIVATE_KEY_WIF=<your_private_key_wif>"': 重要安全提示： 请将 '<your_private_key_wif>' 替换为您实际的 Bitcoin SV 私钥 WIF 格式。务必妥善保管您的私钥，避免泄露！ 该私钥将用于进行钱包相关操作。
- '"bunx"': 使用 'bunx' 命令来执行全局安装的 'bsv-mcp' 包。如果您没有全局安装，而是选择本地运行，请将 '"bunx"' 替换为 '"bun run index.ts"' （假设您在项目根目录）。
- '"bsv-mcp"': 要执行的命令，即 'bsv-mcp' 包的入口文件。

不同 MCP 客户端配置示例:

Cursor: 在 Cursor 的 "Settings → Extensions → Model Context Protocol" 中，点击 "Add a new global MCP server"，然后粘贴上述 JSON 配置，并替换 '<your_private_key_wif>'。
Claude for Desktop: 编辑 Claude for Desktop 的配置文件 'claude_desktop_config.json' (路径通常为 '~/Library/Application\ Support/Claude/claude_desktop_config.json' (macOS/Linux) 或 '%APPDATA%\Claude\claude_desktop_config.json' (Windows))，添加 'mcpServers' 字段，并将上述 JSON 配置添加到 'mcpServers' 中，同样需要替换 '<your_private_key_wif>'。

基本使用方法

成功配置并连接到 MCP 客户端后，您可以使用自然语言指令来调用 BSV 工具。以下是一些示例：

获取 BSV 地址: "Get my Bitcoin SV address"
发送 BSV: "Send 0.01 BSV to 1ExampleBsvAddressXXXXXXXXXXXXXXXXX" 或 "Send $5 USD worth of BSV to 1ExampleBsvAddressXXXXXXXXXXXXXXXXX"
查询 Ordinals NFT 信息: "Show me information about the NFT with outpoint 6a89047af2cfac96da17d51ae8eb62c5f1d982be2bc4ba0d0cd2084b7ffed325_0"
搜索 Ordinals NFT: "Search for Pixel Zoide NFTs"
查询 NFT 市场挂单: "Show me the current marketplace listings for BSV NFTs"
获取 BSV 价格: "What is the current BSV price?"
解码 BSV 交易: "Decode this BSV transaction: (transaction hex or ID)"
数据格式转换: "Convert 'Hello World' from UTF-8 to hex format"

AI 助手会解析您的指令，调用相应的 BSV MCP 工具，并将结果以自然语言形式返回给您。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息