Maestro MCP Server

Maestro API를 사용하여 비트코인 블록체인과 상호작용하며 블록, 트랜잭션 및 주소를 탐색합니다.

문서

Maestro MCP Server

CI

A Model Context Protocol (MCP) server for interacting with Bitcoin via the Maestro API platform. Provides tools for exploring blocks, transactions, addresses, and more on the Bitcoin blockchain.


Quick Links


Getting Started

Requirements

  • Bun v1.0 or higher

Installation & Setup

# Install dependencies
bun install

# Build the project
bun run build

# Copy and edit environment variables
cp .env.example .env
# Edit .env to add your Maestro API key and any other config

Running the Server

bun run start:http
  • The server will start on the port specified in your .env (default: 3000).
  • Access the MCP endpoint at http://localhost:<PORT>/mcp.

Features

  • 🚀 Streamable HTTP MCP server (spec)
  • 🔑 API Key authentication (see .env.example)
  • 📦 Multiple APIs:
    • Blockchain Indexer
    • Mempool Monitoring
    • Market Price
    • Wallet
    • Node RPC
  • 🌐 Supported Networks:
    • Mainnet: API_BASE_URL=https://xbt-mainnet.gomaestro-api.org/v0
    • Testnet4: API_BASE_URL=https://xbt-testnet.gomaestro-api.org/v0

API Reference & Examples


Server Generation

This server is generated using openapi-mcp-generator:

npx openapi-mcp-generator --input openapi-merged.json --output ./ --force --transport streamable-http --port 3000

Contributing & Development

Contributions and feature requests are welcome! Please:

Local Development

  • Use bun run dev for hot-reloading (if configured)
  • Run tests with bun test

Support


License

Apache 2.0