₿itcoin & Lightning Network MCP Server

₿itcoin 和 Lightning Network MCP 服务

概述

一个模型上下文协议（MCP）服务，可让 AI 模型与 Bitcoin 和 Lightning Network 交互，支持生成密钥、验证地址、解码交易、查询区块链等操作。

🎮 演示

Claude 演示 视频	Goose 演示 视频

💼 目录

• ₿itcoin & Lightning Network MCP 服务
  • 概述
  • 🎮 演示
  • 💼 目录
  • 🔧 功能
  • 🔑 Claude Desktop 集成
    • 测试 Claude Desktop 集成
  • 🦆 Goose 集成
    • 使用 STDIO（本地扩展）
      • 使用 SSE（远程扩展）
  • 📦 开发环境设置
    • Lightning Network 配置（可选）
  • 📦 可用工具
  • 🚨 错误处理
  • 🤝 参与贡献
  • 📝 许可证

🔧 功能

• 密钥生成：创建新的 Bitcoin 密钥对，包括地址、公钥和私钥（WIF）。
• 地址验证：验证 Bitcoin 地址是否正确。
• 交易解码：解析原始 Bitcoin 交易，并以易读的格式显示其详细信息。
• 区块链查询：
  • 最新区块：获取最新区块的详细信息（哈希、高度、时间戳、交易数量等）。
  • 交易详情：使用交易的 TXID 获取详细信息。
• Lightning Network：
  • 发票解码：解析 BOLT11 Lightning 发票，并以易读的形式显示信息。
  • 支付：直接通过 LNBits 钱包支付 Lightning 发票。

🔑 Claude Desktop 集成

要在 Claude Desktop（Anthropic 的 Claude 桌面应用）中使用 Bitcoin MCP 服务，请按以下步骤操作：

1. 下载并安装 Claude Desktop： 访问官方 Claude Desktop 下载页面，为你的操作系统（macOS 或 Windows）下载应用（安装 Claude for Desktop | Anthropic 帮助中心）。安装应用，并确保使用的是最新版本（可以在应用菜单中检查更新）。

2. 配置 Claude Desktop 以使用 Bitcoin MCP 服务： 打开 Claude Desktop 配置文件（首次在 Claude Desktop 中编辑设置时会创建该文件）：

   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows： %APPDATA%\Claude\claude_desktop_config.json
     在此 JSON 配置的 "mcpServers" 部分中添加 Bitcoin MCP 服务条目。例如：

   {
     "mcpServers": {
       "bitcoin-mcp": {
         "command": "npx",
         "args": ["-y", "bitcoin-mcp@latest"]
       }
     }
   }
   

   在上面的代码片段中，"bitcoin-mcp" 是服务的标识符（可以随意命名）。command 设置为运行 npx 命令，args 指向 Bitcoin MCP 服务脚本的路径或用于运行该服务的命令。

3. 重启 Claude Desktop： 保存 claude_desktop_config.json 文件，然后关闭并重新打开 Claude Desktop。下次启动时，Claude 会按照配置自动启动 Bitcoin MCP 服务。如果 Claude Desktop 正在运行，则需要重启才能使更改生效。

测试 Claude Desktop 集成

重启 Claude Desktop 后，可以测试 Bitcoin MCP 服务是否正常工作：

• **向 Claude 提出一个与 Bitcoin 相关的示例问题。**例如，试着问："Bitcoin 网络上的最新区块是什么？" 如果集成成功，Claude 的回答应包含通过 MCP 服务获取的最新区块，而不是“我不知道”或泛泛的回答。你也可以尝试其他查询，例如："请提供有关交易 TXID abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890 的信息。" Claude 应使用 MCP 服务的工具检索数据并回答你的问题。

• 验证响应： Claude 应返回详细的回答（例如，Bitcoin 网络上的最新区块），且不出现错误。如果收到错误消息或没有获得有用的响应，MCP 服务可能未正确连接。

• 检查 Claude 的日志（如有需要）： Claude Desktop 提供的日志文件有助于调试 MCP 集成。如果工具没有响应，请检查以下目录中的日志文件：

  • macOS： ~/Library/Logs/Claude/
  • Windows： %APPDATA%\Claude\logs\
    查看 mcp.log，了解常规 MCP 连接消息；查看名为 mcp-server-bitcoin-mcp.log 的文件（或使用其他名称时对应的文件），了解 MCP 服务的输出和错误。这些日志会显示服务是否已启动，或是否发生了错误（例如路径错误或服务中出现异常）。如果发现错误，请按需修正配置或环境，然后重启 Claude Desktop 并再次测试。

🦆 Goose 集成

Goose 是 Block 开发的开源 AI Agent 框架，支持通过 Model Context Protocol 使用扩展。你可以将 Bitcoin MCP 服务集成为 Goose 扩展，以便 Goose 与 Bitcoin 区块链交互。Goose 支持两种 MCP 服务集成模式：将服务作为本地进程运行（STDIO），或通过 Server-Sent Events（SSE）连接到远程服务。以下是这两种方式的操作说明：

使用 STDIO（本地扩展）

此方法会将 Bitcoin MCP 服务作为 Goose 的子进程在本地运行，并通过标准输入/输出进行通信。

1. 在 Goose 中添加新扩展： 打开 Goose 的配置界面。你可以通过运行 goose configure 使用命令行进行配置，也可以在 Goose 桌面应用中前往 Settings > Extensions。从菜单中选择 “Add Extension”。(Using Extensions | goose)

2. 选择扩展类型——命令行扩展： 系统提示选择扩展类型时，在命令行菜单或界面中选择 Command-Line Extension，让 Goose 知道它应启动本地命令 (Using Extensions | goose)（而非内置或远程扩展）。

3. 输入扩展详情： 为 Bitcoin MCP 服务提供名称和命令：

   • 名称： 可以命名为 “bitcoin”，也可以使用任何标识符（之后将通过此名称引用该扩展）。

   • 命令： 指定运行 MCP 服务的方式。例如，如果你有 Python 脚本，请输入运行该脚本的命令。在命令行配置器中，系统可能会询问“应运行什么命令？”——你可以输入：

     npx -y bitcoin-mcp@latest
     

     这会让 Goose 启动 Bitcoin MCP 服务 (GitHub - AbdelStark/bitcoin-mcp: Bitcoin MCP Server)。（请确保使用正确的服务脚本路径或正确的服务运行命令，就像 Claude 配置中的做法一样。）

   • 通常无需在脚本路径之外添加任何参数（除非你的服务需要特殊标志）。上述命令使用默认的 STDIO 传输方式，这是 Goose 对命令行扩展的要求。（在 Goose 配置文件中，这对应于包含 cmd: "npx" 和 args: ["-y", "bitcoin-mcp@latest"] 的条目，其中 type: stdio 表示标准 I/O 模式 (Using Extensions | goose。）

4. 完成并启用： 完成添加扩展。Goose 会将这个新扩展添加到其配置中（通常位于 ~/.config/goose/config.yaml）。请确保扩展已启用（如果使用命令行向导，添加后默认应已启用；在 Goose 桌面应用中，可以查看 Extensions 列表，并在扩展尚未启用时将其打开 (Using Extensions | goose) (Using Extensions | goose)）。

5. 使用新扩展启动 Goose 会话： 现在可以在 Goose 中使用该扩展。如果你通过 CLI 运行 Goose，请运行以下命令来启动包含该扩展的会话：

   goose session --with-extension "bitcoin"
   

将 “bitcoin” 替换为你为扩展指定的名称 (Using Extensions | goose)。（这可确保会话加载该扩展。或者，如果该扩展已全局启用，Goose 桌面应用或 CLI 会在所有会话中自动提供该扩展。）

使用 SSE（远程扩展）

此方法通过 HTTP SSE 流连接 Goose 和已运行的 MCP 服务。如果你想将 Bitcoin MCP 服务作为独立服务运行（可能在另一台机器上运行，或与 Goose 独立运行），请使用此方法。

1. 将 MCP 服务作为独立服务启动： 运行 Bitcoin MCP 服务，使其能够监听连接。实际操作中，这意味着需要以提供 MCP HTTP 端点的模式启动服务。例如，你可以使用特定命令或选项让服务监听某个端口（例如，使用 MCP 库内置的 Web 服务功能，或在 Web 框架下运行）。确保服务可通过已知 URL 访问（例如，http://localhost:9000），并支持通过 SSE 使用 MCP 协议。

2. 在 Goose 中添加新的扩展（远程）： 与之前一样，运行 goose configure 或使用 Goose UI Add Extension（使用扩展 | goose）。这次，在询问扩展类型时选择 Remote Extension（使用扩展 | goose）。这样 Goose 就会通过 SSE 连接到外部服务。

3. 输入远程扩展详情： 为扩展命名（例如，“bitcoin”），并提供服务的 URL。在 URL 中，输入 MCP 服务运行所在的基址。例如，如果服务正在本机的 9000 端口上监听，你可以输入 http://localhost:9000。Goose 会尝试连接该地址上的 MCP 服务 SSE 端点。（Goose 使用标准 MCP SSE 路径，按照惯例，该路径位于服务的 /mcp/sse 路由下。通常只需提供主机和端口，Goose 会处理其余部分。）

4. 启用扩展： 添加远程扩展后，请确保在 Goose 设置中启用它（与 STDIO 情况相同）。只需启用 STDIO 或 SSE 扩展之一（两者提供相同的工具）——如果不慎同时启用了同一服务的本地版和远程版，建议禁用其中一个以免混淆。

在 Goose 中使用 Bitcoin MCP 扩展： 通过上述任一方式设置并启用扩展后，你就可以与 Goose 交互并通过它查询 Bitcoin 数据。在新的 Goose 聊天或会话中，像平常一样提问即可。Goose 会识别何时需要使用 Bitcoin MCP 工具来完成你的请求。例如：

• “最新的 Bitcoin 区块是什么？”
• “请提供交易 TXID abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890 的信息。”

提出这些问题后，Goose 会调用 MCP 服务的工具并返回答案（例如，最新的 Bitcoin 区块信息）。你应该会看到 Goose 通过 MCP 服务返回从 Bitcoin 区块链获取的最新信息。

如果 Goose 似乎没有使用该扩展（例如，它回答说找不到相关信息），请确认扩展已启用且服务正在运行（远程连接时需处于 SSE 模式）。你也可以通过启用详细日志的方式运行 Goose CLI，查看它是否尝试调用该扩展。通常，只要配置正确，Goose 就会自动发现 MCP 服务的功能，并在适用时使用这些功能。

更多资源： 如需进一步了解 Goose 扩展和 MCP，请参阅 Goose 官方文档（使用扩展 | goose）。文档列出了内置扩展和社区扩展，并说明了 MCP 服务如何集成到 Goose 中。你还可以在 Goose 文档和 Model Context Protocol 文档中找到可用 MCP 服务目录及更多配置提示。如果你想探索更多扩展或开发自己的扩展，这些资料会很有帮助。

📦 开发环境设置

请参阅开发环境设置指南中的设置说明。

Lightning Network 配置（可选）

要使用 Lightning Network 功能，你需要配置 LNBits 连接详情。这些配置是可选的，只有计划使用 Lightning Network 工具时才需要。

{
  "lnbitsUrl": "https://demo.lnbits.com",  
  "lnbitsAdminKey": "your_admin_key",      // Required for making payments
  "lnbitsReadKey": "your_read_key"         // Required for wallet information
}

你可以通过以下方式获取这些值：

1. 在 LNBits 创建账户
2. 创建新钱包
3. 前往 API 信息页面查找 API 密钥

📦 可用工具

请参阅API 参考指南，了解可用工具。

🚨 错误处理

该服务使用自定义错误类型处理 Bitcoin 操作和区块链查询。详细的错误消息会使用 Pino 记录，并包含在客户端响应中，以便更轻松地进行调试。

🤝 参与贡献

欢迎贡献和提交功能请求！欢迎在 GitHub 上提交拉取请求或提出问题。

📝 许可证

本项目采用 MIT License 许可。