⚠️ AVISO DE DESAPROBACIÓN

🚨 Este servidor MCP ya no recibe mantenimiento. 🚨

Hemos migrado a una nueva y mejorada implementación del servidor MCP. Todas las futuras actualizaciones, funciones y soporte se proporcionarán allí.

👉 Migre al nuevo servidor MCP aquí: https://github.com/zebedeeio/zbd-payments-typescript-sdk/tree/main/packages/mcp-server

Este repositorio permanecerá disponible como referencia, pero no se recomienda para uso en producción.

Servidor MCP de ZBD (obsoleto; utilice este en su lugar: https://github.com/zebedeeio/zbd-payments-typescript-sdk/tree/main/packages/mcp-server )

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

Related MCP server: Alby Bitcoin Payments MCP Server

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

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

Creando nueva herramienta

Para crear una nueva herramienta:

1. Cree un nuevo archivo TypeScript en el directorio src (por ejemplo, src/mytool.ts )

2. Utilice las herramientas existentes como plantillas

3. 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"

4. 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:

1. send-lightning-payment : envía un pago de Bitcoin Lightning Network a una dirección Lightning usando ZBD

2. send-gamertag-payment : envía un pago de Bitcoin a un gamertag de ZBD

3. create-gamertag-charge - Generar una solicitud de pago para un usuario de ZBD

4. validate-lightning-address - Verificar la validez de una dirección Lightning

5. create-lightning-charge - Generar una solicitud de pago para una dirección Lightning

6. get-userid-by-gamertag - Recuperar el ID de usuario de un gamertag de ZBD

7. get-gamertag-by-userid - Recuperar el gamertag de ZBD de un ID de usuario

8. send-email-payment : envía pagos instantáneos de Bitcoin a cualquier correo electrónico

9. get-wallet-info - Recupera todos los datos sobre la billetera de un proyecto ZBD

10. check-supported-region : verifica si un usuario proviene de una región compatible

11. get-zbd-ip-addresses : obtiene las direcciones IP oficiales de los servidores ZBD

12. internal-transfer : realiza una transferencia de fondos entre dos proyectos

13. create-withdrawal-request - Crea un código QR para retirar Bitcoin

14. get-withdrawal-request - Recupera todos los datos sobre una única solicitud de retiro

15. send-payment - Envía un pago de Bitcoin Lightning Network

16. get-payment - Recupera todos los datos sobre un único pago

17. decode-charge - Comprender las propiedades internas de un código QR de carga

18. create-charge - Crea un nuevo cargo en la red Lightning de Bitcoin

19. get-charge - Recupera todos los datos sobre una sola carga

20. create-voucher : crea un cupón ZBD de un solo uso que cualquier usuario de ZBD puede canjear

21. get-voucher - Recuperar detalles sobre un cupón ZBD

22. redeem-voucher - Canjea un cupón ZBD para acreditar tu billetera del proyecto

23. revoke-voucher : revoca un cupón ZBD válido y recupera los sats en tu billetera de proyecto

24. send-batch-lightning-payments : envía múltiples pagos de Bitcoin Lightning Network a direcciones Lightning en una sola solicitud