Servidor MCP Hebline

Tus agentes pagan de más por cada llamada a la API. Nosotros lo solucionamos.

Hebline dirige cada llamada a la API —incluyendo las llamadas a LLM— al mejor servicio al precio correcto. Gratis cuando es suficiente. De pago cuando importa. Sabe distinguir la diferencia.

Cualquier otro enrutador obtiene un margen de tus llamadas de pago. Dirigirte a alternativas gratuitas acaba con sus ingresos. Sin margen en tus llamadas a la API. Nunca.

¿Por qué Hebline?

Tus agentes están perdiendo dinero. Una tarea activa entre 5 y 10 llamadas a la API de pago a través de diferentes proveedores. Sin transparencia, sin control de costes. Hebline soluciona eso:

• Prioriza lo gratuito — La mayoría de las llamadas no necesitan el mejor modelo. Hebline aprende con precisión cuándo es necesario, y sigue aprendiendo a medida que cambia el mercado.

• Sin margen. Enrutamiento honesto. — No ganamos cuando tú pagas más. Por eso somos el único enrutador diseñado para ahorrarte dinero realmente.

• Abstracción de proveedores — Tu agente dice qué necesita ("geocodifica esta dirección"), no qué servicio usar. Cambia de proveedor sin modificar el código del agente.

• Transparencia de costes — Cada llamada se registra con el servicio utilizado, la latencia y el coste. Conoce exactamente lo que gastan tus agentes.

• Aprende del uso — El aprendizaje hebbiano refuerza lo que funciona y debilita lo que no. Tu intermediario se vuelve más inteligente cada día.

• BYOK (Trae tu propia clave) — Los servicios de pago utilizan tus claves de API a través de variables de entorno. ¿No tienes clave? El servicio se excluye automáticamente del enrutamiento.

• Cumplimiento con el RGPD — Solo se registran metadatos anonimizados. No se almacena el contenido de las llamadas a la API. Opción de alojamiento propio para que ningún dato salga de tu red.

• Código abierto — El servidor MCP principal tiene licencia MIT. Sistema de adaptadores impulsado por la comunidad.

Cómo funciona

Your AI Agent ←→ Hebline MCP Server ←→ Best API (Nominatim, DeepL, Google Maps, ...)
                        │
                   Smart Routing
                   Cost Logging
                   Provider Scoring

Tu agente se conecta a Hebline como un servidor MCP. En lugar de llamar a las APIs directamente, utiliza las herramientas de Hebline: execute, compare o categories. Hebline puntúa todos los servicios disponibles, elige el mejor, realiza la llamada y devuelve el resultado con metadatos completos.

Herramientas MCP disponibles

Inicio rápido

Añadir a Claude Desktop

Añadir a claude_desktop_config.json:

{
  "mcpServers": {
    "hebline": {
      "command": "npx",
      "args": ["-y", "-p", "@hebline.ai/mcp-server", "hebline-mcp"]
    }
  }
}

Añadir a Claude Code

Añadir a .mcp.json:

{
  "mcpServers": {
    "hebline": {
      "command": "hebline-mcp"
    }
  }
}

Añadir a Cursor

Añadir a .cursor/mcp.json:

{
  "mcpServers": {
    "hebline": {
      "command": "npx",
      "args": ["-y", "-p", "@hebline.ai/mcp-server", "hebline-mcp"]
    }
  }
}

Añadir a Windsurf

Añadir a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "hebline": {
      "command": "npx",
      "args": ["-y", "-p", "@hebline.ai/mcp-server", "hebline-mcp"]
    }
  }
}

Añadir a VS Code (Copilot)

Añadir a .vscode/mcp.json:

{
  "servers": {
    "hebline": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "-p", "@hebline.ai/mcp-server", "hebline-mcp"]
    }
  }
}

Instalar globalmente

npm install -g @hebline.ai/mcp-server

Con servicios de pago (opcional)

Establece variables de entorno para cualquier proveedor de pago que desees utilizar:

GOOGLE_MAPS_API_KEY=your-key-here
DEEPL_API_KEY=your-key-here
LIBRETRANSLATE_API_KEY=your-key-here

¿Sin claves? No hay problema: Hebline dirige automáticamente a alternativas gratuitas.

Servicios compatibles

9 categorías, 20 servicios. Los servicios gratuitos funcionan al instante, no se necesita clave de API. Los LLMs se dirigen a través del proxy de Hebline cuando no hay una clave local configurada (50 llamadas gratuitas/día).

Ejemplo

Un agente pregunta: "Geocodifica la Puerta de Brandeburgo en Berlín"

Hebline recibe:

{
  "capability": "geocoding",
  "input": { "query": "Brandenburger Tor, Berlin" },
  "constraint": "free"
}

Hebline responde:

{
  "success": true,
  "data": {
    "lat": 52.5163,
    "lon": 13.3777,
    "displayName": "Brandenburger Tor, Pariser Platz, Berlin, 10117, Deutschland"
  },
  "meta": {
    "service": "Nominatim (OpenStreetMap)",
    "costUsd": 0,
    "latencyMs": 258,
    "score": 0.702,
    "free": true
  }
}

El agente obtuvo las coordenadas, sabe que fue gratuito y Hebline registró la llamada para análisis futuros.

Arquitectura

mcp-server/
├── src/
│   ├── index.ts              # MCP server entry point (stdio transport)
│   ├── types.ts              # Shared TypeScript types
│   ├── registry.ts           # Service definitions (capabilities, costs, scores)
│   ├── router.ts             # Weighted scoring engine (Hopfield-ready)
│   ├── logger.ts             # Append-only JSONL call log (~/.hebline/calls.jsonl)
│   ├── adapters/             # One adapter per service
│   │   ├── nominatim.ts      # Free geocoding
│   │   ├── google-maps.ts    # Paid geocoding (BYOK)
│   │   ├── mymemory.ts       # Free translation
│   │   ├── libretranslate.ts # Paid translation (BYOK)
│   │   └── deepl.ts          # Paid translation (BYOK)
│   └── tools/                # MCP tool definitions
│       ├── execute.ts        # Route + call best service
│       ├── compare.ts        # Score all services
│       └── categories.ts     # List capabilities

Registro de llamadas

Cada llamada a la API se registra en ~/.hebline/calls.jsonl:

{"timestamp":"2026-03-29T09:36:37Z","capability":"geocoding","serviceId":"nominatim","latencyMs":212,"success":true,"costUsd":0}

No se registra contenido, solo metadatos. Estos datos impulsarán el aprendizaje hebbiano en futuras versiones.

Hoja de ruta

• [x] Servidor MCP principal con transporte stdio

• [x] Enrutador de puntuación ponderada

• [x] Adaptadores de geocodificación (Nominatim, Google Maps)

• [x] Adaptadores de traducción (MyMemory, LibreTranslate, DeepL)

• [x] Gestión de claves BYOK

• [x] Registro de llamadas de solo adición

• [x] CI/CD con GitHub Actions

• [ ] Aprendizaje hebbiano: el enrutador aprende del historial de llamadas

• [ ] Puntuación de red de Hopfield (reemplaza la puntuación ponderada)

• [ ] Más categorías (web scraping, divisas, OCR, correo electrónico)

• [ ] Sistema de adaptadores de la comunidad

• [ ] Transporte SSE para despliegues remotos

• [ ] Panel web para análisis de costes

• [ ] Alertas de presupuesto y límites de gasto

• [ ] Atribución de costes multi-agente

Contribución

¡Las contribuciones son bienvenidas! Añadir un nuevo adaptador es sencillo: implementa la interfaz ServiceAdapter y regístralo.

git clone https://github.com/hebline/mcp-server.git
cd mcp-server
npm install
npm run build
npm test

Licencia

MIT

Creado por Hebline — Prioriza lo gratuito. Solo paga cuando sea necesario.