Hebline MCP-Server

Deine Agenten zahlen bei jedem API-Aufruf zu viel. Wir ändern das.

Hebline leitet jeden API-Aufruf – einschließlich LLM-Aufrufen – an den besten Dienst zum richtigen Preis weiter. Kostenlos, wenn es ausreicht. Kostenpflichtig, wenn es darauf ankommt. Er kennt den Unterschied.

Jeder andere Router verdient an deinen kostenpflichtigen Aufrufen mit. Dich zu kostenlosen Alternativen zu leiten, würde deren Umsatz schmälern. Keine Marge auf deine API-Aufrufe. Niemals.

Warum Hebline?

Deine Agenten verschwenden Geld. Eine Aufgabe löst 5–10 kostenpflichtige API-Aufrufe bei verschiedenen Anbietern aus. Keine Transparenz, keine Kostenkontrolle. Hebline behebt das:

• Zuerst kostenlos routen — Die meisten Aufrufe benötigen nicht das beste Modell. Hebline lernt genau, wann es darauf ankommt – und lernt weiter, während sich der Markt verändert.

• Keine Marge. Ehrliches Routing. — Wir verdienen nichts, wenn du mehr bezahlst. Deshalb sind wir der einzige Router, der wirklich darauf ausgelegt ist, dir Geld zu sparen.

• Anbieter-Abstraktion — Dein Agent sagt, was er braucht („Geokodiere diese Adresse“), nicht welchen Dienst er nutzen soll. Wechsle die Anbieter, ohne den Agenten-Code zu ändern.

• Kostentransparenz — Jeder Aufruf wird mit dem verwendeten Dienst, der Latenz und den Kosten protokolliert. Wisse genau, was deine Agenten ausgeben.

• Lernt aus der Nutzung — Hebbian Learning stärkt, was funktioniert, und schwächt, was nicht funktioniert. Dein Broker wird jeden Tag intelligenter.

• BYOK (Bring Your Own Key) — Kostenpflichtige Dienste nutzen deine API-Schlüssel über Umgebungsvariablen. Kein Schlüssel? Der Dienst wird automatisch vom Routing ausgeschlossen.

• DSGVO-konform — Nur anonymisierte Metadaten werden protokolliert. Kein Inhalt der API-Aufrufe wird gespeichert. Selbst gehostete Option, damit keine Daten dein Netzwerk verlassen.

• Open Source — Der Kern-MCP-Server ist MIT-lizenziert. Community-gesteuertes Adaptersystem.

Funktionsweise

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

Dein Agent verbindet sich mit Hebline als MCP-Server. Anstatt APIs direkt aufzurufen, nutzt er die Tools von Hebline – execute, compare oder categories. Hebline bewertet alle verfügbaren Dienste, wählt den besten aus, führt den Aufruf durch und gibt das Ergebnis mit vollständigen Metadaten zurück.

Verfügbare MCP-Tools

Schnellstart

Zu Claude Desktop hinzufügen

Zu claude_desktop_config.json hinzufügen:

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

Zu Claude Code hinzufügen

Zu .mcp.json hinzufügen:

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

Zu Cursor hinzufügen

Zu .cursor/mcp.json hinzufügen:

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

Zu Windsurf hinzufügen

Zu ~/.codeium/windsurf/mcp_config.json hinzufügen:

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

Zu VS Code (Copilot) hinzufügen

Zu .vscode/mcp.json hinzufügen:

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

Global installieren

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

Mit kostenpflichtigen Diensten (optional)

Setze Umgebungsvariablen für alle kostenpflichtigen Anbieter, die du nutzen möchtest:

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

Keine Schlüssel? Kein Problem – Hebline leitet automatisch zu kostenlosen Alternativen weiter.

Unterstützte Dienste

9 Kategorien, 20 Dienste. Kostenlose Dienste funktionieren sofort – kein API-Schlüssel erforderlich. LLMs werden über den Hebline-Proxy geleitet, wenn kein lokaler Schlüssel gesetzt ist (50 kostenlose Aufrufe/Tag).

Beispiel

Ein Agent fragt: "Geokodiere das Brandenburger Tor in Berlin"

Hebline empfängt:

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

Hebline antwortet:

{
  "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
  }
}

Der Agent hat die Koordinaten erhalten, weiß, dass es kostenlos war, und Hebline hat den Aufruf für zukünftige Analysen protokolliert.

Architektur

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

Aufruf-Protokollierung

Jeder API-Aufruf wird in ~/.hebline/calls.jsonl protokolliert:

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

Es werden keine Inhalte protokolliert – nur Metadaten. Diese Daten werden in zukünftigen Versionen das Hebbian Learning antreiben.

Roadmap

• [x] Kern-MCP-Server mit stdio-Transport

• [x] Gewichteter Bewertungs-Router

• [x] Geokodierungs-Adapter (Nominatim, Google Maps)

• [x] Übersetzungs-Adapter (MyMemory, LibreTranslate, DeepL)

• [x] BYOK-Schlüsselverwaltung

• [x] Nur-Anhängen-Aufrufprotokollierung

• [x] CI/CD mit GitHub Actions

• [ ] Hebbian Learning — Router lernt aus der Aufrufhistorie

• [ ] Hopfield-Netzwerk-Bewertung (ersetzt gewichtete Bewertung)

• [ ] Weitere Kategorien (Web Scraping, Währung, OCR, E-Mail)

• [ ] Community-Adaptersystem

• [ ] SSE-Transport für Remote-Bereitstellungen

• [ ] Web-Dashboard für Kostenanalysen

• [ ] Budget-Warnungen und Ausgabenlimits

• [ ] Multi-Agenten-Kostenzuordnung

Mitwirken

Beiträge sind willkommen! Das Hinzufügen eines neuen Adapters ist unkompliziert – implementiere das ServiceAdapter-Interface und registriere es.

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

Lizenz

MIT

Erstellt von Hebline — Zuerst kostenlos routen. Nur bezahlen, wenn es notwendig ist.