Hebline MCP Server

Ваши агенты переплачивают за каждый вызов API. Мы это исправим.

Hebline направляет каждый вызов API — включая вызовы LLM — к лучшему сервису по правильной цене. Бесплатно, когда этого достаточно. Платно, когда это важно. Он знает разницу.

Любой другой маршрутизатор зарабатывает на ваших платных вызовах. Направление вас к бесплатным альтернативам убивает их доход. Никакой наценки на ваши вызовы API. Никогда.

Почему Hebline?

Ваши агенты теряют деньги. Одна задача запускает 5–10 платных вызовов API у разных провайдеров. Никакой прозрачности, никакого контроля затрат. Hebline исправляет это:

• Сначала бесплатно — Большинству вызовов не нужна лучшая модель. Hebline точно знает, когда это важно — и продолжает учиться по мере изменения рынка.

• Никакой наценки. Честная маршрутизация. — Мы не зарабатываем, когда вы платите больше. Поэтому мы — единственный маршрутизатор, созданный для того, чтобы реально экономить ваши деньги.

• Абстракция провайдеров — Ваш агент говорит, что ему нужно («геокодировать этот адрес»), а не какой сервис использовать. Меняйте провайдеров, не меняя код агента.

• Прозрачность затрат — Каждый вызов регистрируется с указанием использованного сервиса, задержки и стоимости. Знайте точно, сколько тратят ваши агенты.

• Обучение на основе использования — Обучение по Хеббу усиливает то, что работает, и ослабляет то, что не работает. Ваш брокер становится умнее с каждым днем.

• BYOK (Принеси свой ключ) — Платные сервисы используют ваши ключи API через переменные окружения. Нет ключа? Сервис автоматически исключается из маршрутизации.

• Соответствие GDPR — Регистрируются только анонимизированные метаданные. Содержимое вызовов API не сохраняется. Доступна опция самостоятельного хостинга, чтобы данные не покидали вашу сеть.

• Open Source — Основной MCP-сервер распространяется по лицензии MIT. Система адаптеров, управляемая сообществом.

Как это работает

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

Ваш агент подключается к Hebline как к MCP-серверу. Вместо прямого вызова API он использует инструменты Hebline — execute, compare или categories. Hebline оценивает все доступные сервисы, выбирает лучший, выполняет вызов и возвращает результат с полными метаданными.

Доступные инструменты MCP

Быстрый старт

Добавление в Claude Desktop

Добавьте в claude_desktop_config.json:

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

Добавление в Claude Code

Добавьте в .mcp.json:

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

Добавление в Cursor

Добавьте в .cursor/mcp.json:

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

Добавление в Windsurf

Добавьте в ~/.codeium/windsurf/mcp_config.json:

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

Добавление в VS Code (Copilot)

Добавьте в .vscode/mcp.json:

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

Глобальная установка

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

С платными сервисами (опционально)

Установите переменные окружения для любых платных провайдеров, которые вы хотите использовать:

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

Нет ключей? Не проблема — Hebline автоматически направляет запросы к бесплатным альтернативам.

Поддерживаемые сервисы

9 категорий, 20 сервисов. Бесплатные сервисы работают мгновенно — ключ API не требуется. LLM направляются через прокси Hebline, если локальный ключ не задан (50 бесплатных вызовов в день).

Пример

Агент спрашивает: "Геокодируй Бранденбургские ворота в Берлине"

Hebline получает:

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

Hebline отвечает:

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

Агент получил координаты, знает, что это было бесплатно, а Hebline записал вызов для будущего анализа.

Архитектура

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

Логирование вызовов

Каждый вызов API записывается в ~/.hebline/calls.jsonl:

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

Содержимое не логируется — только метаданные. Эти данные будут использоваться для обучения по Хеббу в будущих версиях.

Дорожная карта

• [x] Основной MCP-сервер с транспортом stdio

• [x] Маршрутизатор с взвешенной оценкой

• [x] Адаптеры геокодирования (Nominatim, Google Maps)

• [x] Адаптеры перевода (MyMemory, LibreTranslate, DeepL)

• [x] Управление ключами BYOK

• [x] Логирование вызовов только на добавление

• [x] CI/CD с GitHub Actions

• [ ] Обучение по Хеббу — маршрутизатор учится на истории вызовов

• [ ] Оценка сети Хопфилда (заменяет взвешенную оценку)

• [ ] Больше категорий (веб-скрейпинг, валюта, OCR, электронная почта)

• [ ] Система адаптеров сообщества

• [ ] Транспорт SSE для удаленных развертываний

• [ ] Веб-панель для аналитики затрат

• [ ] Бюджетные оповещения и лимиты расходов

• [ ] Атрибуция затрат для нескольких агентов

Вклад в проект

Вклад приветствуется! Добавление нового адаптера просто — реализуйте интерфейс ServiceAdapter и зарегистрируйте его.

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

Лицензия

MIT

Создано Hebline — Сначала бесплатно. Платите только тогда, когда это необходимо.