JinDaGe - maestro-mcp MCP Details

article

README

🚀 Maestro MCP 服务器

Maestro MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，可通过 Maestro API 平台与 Bitcoin 进行交互。此项目提供了一系列工具，能够帮助用户探索比特币区块链的区块、交易、地址等方面的内容。

🚀 快速开始

Maestro MCP 服务器为开发者提供了与比特币区块链交互的便捷途径。以下将详细介绍如何安装、配置和使用该服务器。

📦 安装指南

先决条件

Python >=3.10
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 .

✨ 主要特性

区块链探索：可探索比特币区块链的区块、交易、地址等内容。
API 交互：通过 Maestro API 平台与比特币进行交互。

📚 详细文档

配置Claude（桌面版）

从这里下载 Claude 桌面版。

步骤

打开 Claude 桌面设置
选择 Edit Config
打开位于 ~/Library/Application Support/Claude/claude_desktop_config.json 的 Claude 应用配置文件，并将以下内容复制到此文件中

你需要三件事：

/uv 的绝对路径；例如，which uv
maestro-mcp 仓库的绝对路径
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。

启动 Claude 桌面版
找到锤子图标
查看可用的 MCP 工具
提示 Claude
- "获取最新 Bitcoin 区块"
- "获取 Bitcoin 的区块链信息"

⚠️ 重要提示

修改 claude_desktop_config.json 或源代码后，需要重启 Claude。

调试

如果遇到问题，请打开一个issues或在 Discord 上联系。

支持的端点

| 端点 | 功能 | |------|------| | /v0/blocks | 获取最新区块 | | /v0/tx | 提交交易 | | /v0/address | 查询地址信息 |

贡献

欢迎任何贡献！请清晰地记录所需内容。随时提交 pull request 或打开一个issues。

支持

如果你在上述过程中遇到任何问题，请打开一个issues或联系 Discord。

📄 许可证

Apache 2.0

maestro-mcp