ZBD MCP Server

⚠️ 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

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

Ventanas

Verifique su instalación ejecutando:

Instalación

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 :

4. Actualice el build:all para incluir su nueva herramienta

Uso

Construyendo ejecutables

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

Notas del cursor

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

Alternativamente, puede ejecutar los archivos TypeScript directamente con Node:

Pruebas

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