Servidor MCP ZBD

Añade poderes de Bitcoin a tu LLM.

SDK base

Este servidor MCP utiliza el SDK oficial de TypeScript: https://github.com/modelcontextprotocol/typescript-sdk

Prerrequisitos

Node.js 23+ (o Bun/Deno/cualquier cosa que admita la ejecución de archivos .ts)
Bun (para construir ejecutables)
Clave API de ZBD para el procesamiento de pagos

Configuración de ZBD

Obtén tu clave API del Panel de desarrollador de ZBD y colócala en un nuevo archivo .env bajo ZBD_API_KEY=XXXXXXXXXXXX (consulta .env.example para ver un ejemplo).

Una vez hecho esto, ejecute el comando pnpm build y configure el servidor MCP en su cliente (por ejemplo, Claude Desktop o Cursor).

Instalación de Bun

Si no tienes Bun instalado, puedes instalarlo utilizando uno de los siguientes métodos:

macOS y Linux

# Using curl (recommended)
curl -fsSL https://bun.sh/install | bash

# Using Homebrew
brew install oven-sh/bun/bun

# Using npm
npm install -g bun

Ventanas

# Using PowerShell
powershell -c "irm bun.sh/install.ps1|iex"

# Using npm
npm install -g bun

# Using Scoop
scoop install bun

Verifique su instalación ejecutando:

bun --version

Instalación

pnpm install

Solución de problemas

Utilice ps aux | grep mcp-zbd | grep -v grep para enumerar todas las instancias del servidor ZBD MCP en ejecución.
Utilice pkill -f mcp-zbd para eliminar cualquier instancia duplicada del servidor ZBD MCP que pueda permanecer.

Estructura del proyecto

Este proyecto demuestra un enfoque modular para crear herramientas MCP:

Cada herramienta se define en su propio archivo TypeScript en el directorio src
Cada herramienta se puede integrar en un ejecutable independiente en el directorio bin
El índice principal index.ts proporciona la implementación de herramientas real.

Herramientas disponibles

ZBD ( src/zbd.ts ): API de ZBD para pagos globales de Bitcoin Lightning

Creando nueva herramienta

Para crear una nueva herramienta:

Cree un nuevo archivo TypeScript en el directorio src (por ejemplo, src/mytool.ts )
Utilice las herramientas existentes como plantillas
Agregue un script de compilación a package.json :

"build:mytool": "mkdir -p bin && bun build src/mytool.ts --compile --minify --sourcemap --outfile bin/mcp-mytool"

Actualice el build:all para incluir su nueva herramienta

Uso

Construyendo ejecutables

# Build all tools
pnpm build

# Build a specific tool
pnpm build:zbd

Los ejecutables resultantes estarán en el directorio bin y se pueden ejecutar directamente:

./bin/mcp-zbd

Notas del cursor

Al utilizar estas herramientas con Cursor, utilice siempre la ruta completa al ejecutable:

/path/to/your/project/bin/mcp-zbd

Alternativamente, puede ejecutar los archivos TypeScript directamente con Node:

/path/to/node ~/path/to/project/src/index.ts

Pruebas

# Run all tests
pnpm test

# Run tests in watch mode
pnpm test:watch

# Run tests with coverage
pnpm test:coverage

Herramientas disponibles de ZBD.ts

Las siguientes herramientas están disponibles en el servidor ZBD MCP:

send-lightning-payment : envía un pago de Bitcoin Lightning Network a una dirección Lightning usando ZBD
send-gamertag-payment : envía un pago de Bitcoin a un gamertag de ZBD
create-gamertag-charge - Generar una solicitud de pago para un usuario de ZBD
validate-lightning-address - Verificar la validez de una dirección Lightning
create-lightning-charge - Generar una solicitud de pago para una dirección Lightning
get-userid-by-gamertag - Recuperar el ID de usuario de un gamertag de ZBD
get-gamertag-by-userid - Recuperar el gamertag de ZBD de un ID de usuario
send-email-payment : envía pagos instantáneos de Bitcoin a cualquier correo electrónico
get-wallet-info - Recupera todos los datos sobre la billetera de un proyecto ZBD
check-supported-region : verifica si un usuario proviene de una región compatible
get-zbd-ip-addresses : obtiene las direcciones IP oficiales de los servidores ZBD
internal-transfer : realiza una transferencia de fondos entre dos proyectos
create-withdrawal-request - Crea un código QR para retirar Bitcoin
get-withdrawal-request - Recupera todos los datos sobre una única solicitud de retiro
send-payment - Envía un pago de Bitcoin Lightning Network
get-payment - Recupera todos los datos sobre un único pago
decode-charge - Comprender las propiedades internas de un código QR de carga
create-charge - Crea un nuevo cargo en la red Lightning de Bitcoin
get-charge - Recupera todos los datos sobre una sola carga
create-voucher : crea un cupón ZBD de un solo uso que cualquier usuario de ZBD puede canjear
get-voucher - Recuperar detalles sobre un cupón ZBD
redeem-voucher - Canjea un cupón ZBD para acreditar tu billetera del proyecto
revoke-voucher : revoca un cupón ZBD válido y recupera los sats en tu billetera de proyecto
send-batch-lightning-payments : envía múltiples pagos de Bitcoin Lightning Network a direcciones Lightning en una sola solicitud

ZBD MCP Server

Integrations