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.

Se ejecuta como un proceso independiente utilizando stdio para la comunicación.
Registra recursos y herramientas para acceder a los servicios de Bitrefill
Interfaces con la API de Bitrefill para proporcionar búsqueda y detalles de productos
Devuelve respuestas JSON estructuradas que pueden ser procesadas por asistentes de IA

Arquitectura

El servidor de aplicaciones sigue esta arquitectura:

src/
├── index.ts                # Main entry point
├── constants/              # Static data
│   ├── categories.ts       # Product categories
│   └── payment_methods.ts  # Payment methods
├── handlers/               # MCP request handlers
│   ├── resources.ts        # Resource endpoints
│   └── tools.ts            # Tool implementations
├── schemas/                # Data validation schemas
│   ├── detail.ts           # Product detail response types
│   ├── invoice.ts          # Invoice schemas
│   ├── misc.ts             # Miscellaneous schemas
│   ├── order.ts            # Order schemas
│   └── search.ts           # Search parameters and response types
├── services/               # API services
│   ├── invoices.ts         # Invoice service
│   ├── misc.ts             # Miscellaneous services
│   ├── orders.ts           # Order services
│   ├── products.ts         # Product details service
│   └── search.ts           # Search functionality
└── utils/                  # Utility functions
    ├── index.ts            # Error logging, etc.
    └── api/                # API clients
        ├── authenticated.ts # Authenticated API client
        ├── base.ts         # Base API client
        └── public.ts       # Public API client

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:

Crear una cuenta de Bitrefill
Solicite una clave API de desarrollador completando una solicitud en este formulario
Crea un archivo .env en el directorio raíz (puedes copiarlo desde .env.example )
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:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

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:

npm run inspector

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 :

npx -y @smithery/cli install @bitrefill/bitrefill-mcp-server --client claude

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

{
  "mcpServers": {
    "bitrefill": {
      "command": "npx",
      "args": ["-y", "bitrefill-mcp-server"],
      "env": {
        "BITREFILL_API_SECRET": "your_api_key_here",
        "BITREFILL_API_ID": "your_api_id_here"
      }
    }
  }
}

Cline

Abra la configuración de la extensión Cline
Abra la pestaña "Servidores MCP"
Haga clic en "Configurar servidores MCP"
Agregue la configuración del servidor:

{
  "mcpServers": {
    "github.com/bitrefill/bitrefill-mcp-server": {
      "command": "npx",
      "args": ["-y", "bitrefill-mcp-server"],
      "disabled": false,
      "autoApprove": ["search", "detail", "categories"],
      "env": {
        "BITREFILL_API_ID": "your_api_id_here",
        "BITREFILL_API_SECRET": "your_api_key_here"
      }
    }
  }
}

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

Abra la configuración del cursor
Abra la configuración de "Funciones"
En la sección "Servidores MCP", haga clic en "Agregar nuevo servidor MCP".
Elija un nombre y seleccione "comando" como "Tipo".
En el campo "Comando", ingrese lo siguiente:

npx -y bitrefill-mcp-server

(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:

docker build -t bitrefill-mcp-server .

Luego ejecuta el contenedor:

docker run -e BITREFILL_API_SECRET=your_api_key_here -e BITREFILL_API_ID=your_api_id_here bitrefill-mcp-server

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

docker run -v $(pwd):/app --env-file .env bitrefill-mcp-server

Bitrefill Search and Shop

Integrations