Maestro MCP Server

Interactúa con la blockchain de Bitcoin usando la API de Maestro para explorar bloques, transacciones y direcciones.

GitHub
25

Documentación

Servidor Maestro MCP

CI

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con Bitcoin a través de la plataforma API de Maestro. Proporciona herramientas para explorar bloques, transacciones, direcciones y más en la cadena de bloques de Bitcoin.

Enlaces rápidos

Primeros pasos

Requisitos

  • Bun v1.0 o superior

Instalación y configuración

# 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

Ejecutar el servidor

bun run start:http
  • El servidor se iniciará en el puerto especificado en tu .env (predeterminado: 3000).
  • Accede al endpoint de MCP en http://localhost:<PORT>/mcp.

Características

  • 🚀 Servidor MCP HTTP transmisible (especificación)
  • 🔑 Autenticación con clave API (consulta .env.example)
  • 📦 Múltiples APIs:
    • Indexador de cadena de bloques
    • Monitoreo de mempool
    • Precio de mercado
    • Billetera
    • RPC de nodo
  • 🌐 Redes compatibles:
    • Mainnet: API_BASE_URL=https://xbt-mainnet.gomaestro-api.org/v0
    • Testnet4: API_BASE_URL=https://xbt-testnet.gomaestro-api.org/v0

Referencia de API y ejemplos

Generación del servidor

Este servidor se genera usando openapi-mcp-generator:

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

Contribuciones y desarrollo

¡Las contribuciones y solicitudes de funciones son bienvenidas! Por favor:

Desarrollo local

  • Usa bun run dev para recarga en caliente (si está configurado)
  • Ejecuta las pruebas con bun test

Soporte

Licencia

Apache 2.0