Maestro MCP 服务器

<img src="https://github.com/user-attachments/assets/98413b13-42c0-4438-9231-e61cdb946039" width="500"><br />

一个模型上下文协议 (MCP) 服务器，用于通过 Maestro API 平台与 Bitcoin 交互。此软件包提供了一组工具，用于探索 Bitcoin 区块链的区块、交易、地址和其他方面。

安装

要求

• Python >=3.10
• Python MCP SDK >= 1.2.0
• uv

安装 UV

curl -LsSf https://astral.sh/uv/install.sh | sh

设置虚拟环境

# 创建一个虚拟环境
uv venv

# 激活虚拟环境
# Linux/MacOS
source .venv/bin/activate
# Windows
# .venv\Scripts\activate

# 安装依赖
uv pip install .

配置 Claude (桌面版)

在此处下载 Claude 桌面版：这里。

步骤

1. 打开 Claude 桌面版设置

   

2. 选择 Edit Config

   

3. 打开位于以下位置的 Claude 应用程序配置文件：~/Library/Application Support/Claude/claude_desktop_config.json，并将以下内容复制到此文件中

您将需要 3 样东西：

1. uv 的绝对路径；例如，which uv
2. mcp-maestro 仓库的绝对路径
3. Maestro API 密钥

{
  "mcpServers": {
    "maestro-mcp": {
      "command": "/ABSOLUTE/PATH/TO/uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/maestro-mcp",
        "run",
        "maestro.py"
      ],
      "env": {
        "MAESTRO_BASE_URL": "https://xbt-mainnet.gomaestro-api.org/v0",
        "MAESTRO_API_KEY": "<MAESTRO_API_KEY>"
      }
    }
  }
}

用法

• 在对 claude_desktop_config.json 或源代码进行任何更改后，重新启动 Claude。

1. 启动 Claude 桌面版

2. 找到锤子图标

3. 查看可用的 MCP 工具

4. 提示 Claude

• “获取最新的 Bitcoin 区块”

• “获取 Bitcoin 的区块链信息”

  

注意： 您需要在 Claude 中批准该请求。

调试

CLI 检查器工具

• mcp-cli

日志

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-maestro-mcp.log

支持的端点

• /mempool/addresses/:id/utxos
• /transactions/:id
• /rpc/general/info
• /rpc/block/latest
• /rpc/transaction/:id
• /rpc/transaction/submit
• /assets/runes
• /assets/runes/:id
• /addresses/:id/runes
• /addresses/:id/utxos
• /addresses/:id/runes/:id
• /addresses/:id/txs

所有 Maestro API 规范都可以在我们的 Postman 工作区中找到。

支持

如果您在使用上述内容时遇到任何问题，请打开一个 issue 或在 Discord 上联系我们。