Servidor MCP de Bitrefill

Un servidor MCP basado en TypeScript que proporciona acceso a los servicios de Bitrefill, lo que permite buscar tarjetas de regalo, recargas móviles y más. Este servidor implementa el Protocolo de Contexto de Modelo para exponer la funcionalidad de Bitrefill a los asistentes de IA.

Cómo funciona

El servidor opera mediante el Protocolo de Contexto de Modelo (MCP) para comunicarse con Claude y asistentes de IA similares.

1. Se ejecuta como un proceso independiente utilizando stdio para la comunicación.

2. Registra recursos y herramientas para acceder a los servicios de Bitrefill

3. Interfaces con la API de Bitrefill para proporcionar búsqueda y detalles de productos

4. Devuelve respuestas JSON estructuradas que pueden ser procesadas por asistentes de IA

Arquitectura

El servidor de aplicaciones sigue esta arquitectura:

Características

Recursos

• bitrefill://product-types - Lista de tipos de productos disponibles en Bitrefill

• bitrefill://categories/{type} - Lista de categorías disponibles para un tipo de producto específico (por ejemplo, bitrefill://categories/gift-cards )

Herramientas

• search : busca tarjetas de regalo, eSIM, recargas móviles y más.

  • Obligatorio: query (por ejemplo, 'Amazon', 'Netflix', 'AT&T' o '*' para todos)

  • Opcional: country , language , limit , skip , category

• detail - Obtenga información detallada sobre un producto

  • Obligatorio: id (identificador del producto)

• categories - Obtenga el mapa completo de tipos/categorías de productos

  • No hay parámetros requeridos

• create_invoice - Crea una nueva factura para comprar productos (requiere clave API)

  • Requerido: products (conjunto de productos a incluir en la factura)

    • Cada producto requiere: product_id

    • Campos de producto opcionales: quantity , value , package_id , phone_number , email , send_email , send_sms

  • Obligatorio: payment_method (uno de los siguientes: "balance", "bitcoin", "lightning")

  • Opcional: webhook_url , auto_pay

• get_invoices - Recupera una lista de facturas con filtrado opcional

  • Opcional: start , limit , after , before

• get_invoice - Recuperar detalles de una factura específica por ID

  • Obligatorio: id (identificador de la factura)

• pay_invoice - Pagar una factura impaga (solo funciona con el método de pago 'saldo')

  • Obligatorio: id (identificador de la factura)

• get_orders - Recupera una lista de pedidos con filtrado opcional

  • Opcional: start , limit , after , before

• get_order - Recuperar detalles de un pedido específico por ID

  • Obligatorio: id (identificador del pedido)

• unseal_order - Revela códigos y PIN para un pedido específico por ID

  • Obligatorio: id (identificador del pedido)

• get_account_balance - Recupera el saldo de tu cuenta

  • No hay parámetros requeridos

• ping - Comprueba si la API de Bitrefill está disponible

  • No hay parámetros requeridos

Configuración

Configuración de la clave API

Para utilizar todas las herramientas que dependen de la API de Bitrefill, excepto search , categories y detail , debe configurar las credenciales de la API de Bitrefill:

1. Crear una cuenta de Bitrefill

2. Solicite una clave API de desarrollador completando una solicitud en este formulario

3. Crea un archivo .env en el directorio raíz (puedes copiarlo desde .env.example )

4. Agregue sus credenciales de API de Bitrefill:

   BITREFILL_API_SECRET=your_api_key_here BITREFILL_API_ID=your_api_id_here

La herramienta create_invoice solo estará disponible si se configuran las credenciales de API. Si no se configuran, la herramienta no se registrará y no aparecerá en la lista de herramientas disponibles.

Desarrollo

Instalar dependencias:

Construir el servidor:

Para desarrollo con reconstrucción automática:

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

Instalación

Instalación mediante herrería

Para instalar Bitrefill para Claude Desktop automáticamente a través de Smithery :

Escritorio de Claude

Agregue la configuración del servidor en:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Ventanas: %APPDATA%/Claude/claude_desktop_config.json

Cline

1. Abra la configuración de la extensión Cline

2. Abra la pestaña "Servidores MCP"

3. Haga clic en "Configurar servidores MCP"

4. Agregue la configuración del servidor:

Opciones de configuración adicionales de Cline:

• disabled : establezca en false para habilitar el servidor

• autoApprove : Lista de herramientas que no requieren aprobación explícita para cada uso

Cursor

1. Abra la configuración del cursor

2. Abra la configuración de "Funciones"

3. En la sección "Servidores MCP", haga clic en "Agregar nuevo servidor MCP".

4. Elija un nombre y seleccione "comando" como "Tipo".

5. En el campo "Comando", ingrese lo siguiente:

6. (Opcional) Si está utilizando la herramienta create_invoice , agregue variables de entorno:

   • BITREFILL_API_SECRET: tu_clave_API_aquí

   • BITREFILL_API_ID: su_id_de_api_aquí

Estibador

También puedes ejecutar el servidor con Docker. Primero, crea la imagen:

Luego ejecuta el contenedor:

Para el desarrollo, es posible que desees montar tu código fuente como un volumen: