Maestro MCP

🚀 Maestro MCP サーバー

Maestro API プラットフォームを通じて Bitcoin とやり取りするための Model Context Protocol (MCP) サーバーです。このパッケージには、ブロック、トランザクション、アドレスなどの Bitcoin ブロックチェーンの内容を探索するためのツールが用意されています。

🚀 クイックスタート

この Maestro MCP サーバーは、Maestro API プラットフォームを介して Bitcoin とのやり取りを可能にします。以下の手順に沿って、サーバーをセットアップして使用しましょう。

📦 インストール

前提条件

• 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 .

📚 ドキュメント

Claude（デスクトップ版）の設定

こちら から Claude デスクトップ版をダウンロードします。

手順

1. Claude デスクトップ設定を開きます。
2. Edit Config を選択します。
3. ~/Library/Application Support/Claude/claude_desktop_config.json にある Claude アプリケーションの設定ファイルを開き、以下の内容をこのファイルにコピーします。

必要なものは3つです。

1. /uv の絶対パス；例えば、which uv
2. maestro-mcp リポジトリの絶対パス
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_desktop_config.json またはソースコードを変更した後は、Claude を再起動する必要があります。

デバッグ

問題が発生した場合は、issues を開く か、Discord で連絡してください。

サポートされるエンドポイント

• /v0/blocks：最新のブロックを取得する
• /v0/tx：トランザクションを送信する
• /v0/address：アドレス情報を照会する

コントリビューション

どんな貢献も歓迎します！必要な内容を明確に記録してください。いつでも pull request を送信するか、issues を開く ことができます。

サポート

上記の手順で問題が発生した場合は、issues を開く か、Discord で連絡してください。

📄 ライセンス

Apache 2.0