Maestro Bitcoin MCP服务器

关键词

Bitcoin区块链Maestro API数据查询交易

使用说明

项目简介

Maestro MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型（LLM）客户端提供访问 Bitcoin 区块链数据的能力。它利用 Maestro API 平台作为数据源，将复杂的 Bitcoin 区块链信息转化为易于 LLM 理解和使用的工具。通过此服务器，LLM 可以查询 Bitcoin 区块链的各种信息，例如区块、交易、地址和 Rune 资产等，并可以提交 Bitcoin 交易。

主要功能点

  • 区块链信息查询: 提供查询 Bitcoin 区块链基本信息的功能，例如链信息、最新区块等。
  • 区块和交易查询: 支持根据区块哈希或交易 ID 查询区块和交易的详细信息。
  • 地址信息查询: 允许查询特定 Bitcoin 地址的交易记录、UTXO（未花费的交易输出）、Rune 资产余额等。
  • Rune 资产查询: 提供 Rune 资产的元数据查询和地址 Rune 资产余额查询功能。
  • 交易提交: 支持提交原始 Bitcoin 交易到网络。
  • Mempool 数据访问: 提供访问 Mempool 中与地址相关的 UTXO 信息，获取更实时的交易状态。

安装步骤

  1. 安装 Python 3.10 或更高版本。
  2. 安装 'uv' 包管理器: 按照仓库 README.md 提供的命令执行： 
    curl -LsSf https://astral.sh/uv/install.sh | sh
  3. 克隆仓库 'maestro-mcp' 到本地。
  4. 创建并激活 Python 虚拟环境: 在仓库根目录下执行： 
    uv venv
source .venv/bin/activate  # Linux/MacOS
# .venv\Scripts\activate  # Windows
  5. 安装项目依赖: 在虚拟环境激活状态下，于仓库根目录下执行： 
    uv pip install .

服务器配置

本MCP服务器需要配置 Maestro API 的访问密钥才能正常工作。您需要在 Claude Desktop (或其他 MCP 客户端) 的配置文件中指定服务器的启动命令和相关参数。

Claude Desktop 配置示例 (claude_desktop_config.json):

{
  "mcpServers": {
    "maestro-mcp": {
      "command": "/ABSOLUTE/PATH/TO/uv",  // 替换为 uv 的绝对路径，例如 /usr/local/bin/uv (使用 'which uv' 命令查找)
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/maestro-mcp", // 替换为 maestro-mcp 仓库的绝对路径，例如 /Users/yourname/maestro-mcp
        "run",
        "maestro.py"
      ],
      "env": {
        "MAESTRO_BASE_URL": "https://xbt-mainnet.gomaestro-api.org/v0", // Maestro API 基础 URL，通常无需修改
        "MAESTRO_API_KEY": "<YOUR_MAESTRO_API_KEY>" // 替换为您的 Maestro API 密钥
      }
    }
  }
}

配置说明:

  • '"command"': 指定 'uv' 包管理器的绝对路径。'uv' 用于在虚拟环境中运行 Python 代码。
  • '"args"': 启动参数列表。
    • '"--directory"': 指定 MCP 服务器代码所在的目录（即 'maestro-mcp' 仓库的绝对路径）。
    • '"run"': 'uv run' 命令用于运行指定的 Python 脚本。
    • '"maestro.py"': 指定要运行的 MCP 服务器主脚本。
  • '"env"': 环境变量配置。
    • '"MAESTRO_BASE_URL"': Maestro API 的基础 URL，默认已配置为 'https://xbt-mainnet.gomaestro-api.org/v0'，一般无需修改。
    • '"MAESTRO_API_KEY"': 您需要在此处替换为您在 Maestro API 平台申请的 API 密钥。 请务必替换 '<YOUR_MAESTRO_API_KEY>' 为您的真实 API 密钥，否则服务器将无法访问 Maestro API。

获取 Maestro API 密钥: 您需要在 Maestro 平台 注册并获取 API 密钥。

配置 Claude Desktop:

  1. 打开 Claude Desktop 应用。
  2. 进入设置 (Settings)。
  3. 点击 "Edit Config" 按钮。
  4. 打开 'claude_desktop_config.json' 文件，并将上述 JSON 配置代码复制粘贴到 'mcpServers' 字段中。
  5. 重启 Claude Desktop 使配置生效。

基本使用方法

  1. 启动 Claude Desktop (确保已完成配置并重启)。
  2. 在 Claude Desktop 中，点击左侧工具栏的 锤子图标 (MCP 工具)。
  3. 您应该能看到名为 "maestro-mcp" 的服务器及其提供的工具列表。
  4. 在 Claude Desktop 的聊天输入框中，使用自然语言提示词调用工具，例如：
    • "Fetch the latest Bitcoin block" (获取最新的 Bitcoin 区块)
    • "Get the blockchain info for Bitcoin" (获取 Bitcoin 区块链信息)
    • "Get transactions for address [Bitcoin address]" (查询指定 Bitcoin 地址的交易)
    • "Get UTXOs for address [Bitcoin address]" (查询指定 Bitcoin 地址的 UTXO)

注意: 首次调用 MCP 工具时，Claude Desktop 可能会请求您授权访问，请点击 "Allow" (允许) 以继续。

Debugging

  • CLI inspector tool: 可以使用 'mcp-cli' 工具 (https://github.com/wong2/mcp-cli) 来调试和检查 MCP 服务器的运行情况。
  • Logs: 服务器日志文件位于 '~/Library/Logs/Claude/mcp-server-maestro-mcp.log' (MacOS)，可以使用 'tail -f' 命令查看实时日志。

请确保已正确配置 API 密钥和 Claude Desktop，并按照步骤操作。如有问题，请参考仓库的 Issue 页面或 Discord 寻求帮助。

服务器信息

访问项目