Hebline Mcp Server Any Api Broker

Hebline MCP Server

エージェントは API を呼び出すたびに余分な料金を支払っています。私たちが解決します。

Hebline は、LLM の呼び出しを含むすべての API 呼び出しを、適切な価格で最適なサービスにルーティングします。十分な場合は無料で、必要な場合は有料で対応します。その違いを見極めます。

ほかのルーターはすべて、有料の呼び出しからマージンを得ています。無料の代替サービスにルーティングすれば、収益がなくなるからです。API 呼び出しにマージンは一切上乗せしません。

Hebline を選ぶ理由

エージェントは費用を浪費しています。1 つのタスクで、複数のプロバイダーに対して 5～10 回の有料 API 呼び出しが発生します。透明性もコスト管理もありません。Hebline が解決します。

• まず無料のサービスにルーティング — ほとんどの呼び出しで、最良のモデルは必要ありません。Hebline はそれが必要なタイミングを正確に学習し、市場の変化に合わせて学習を続けます。
• マージンなし。誠実なルーティング。 — より多く支払っても、私たちの収益にはなりません。だからこそ、実際に費用を節約できるように作られた唯一のルーターです。
• プロバイダーの抽象化 — エージェントは、使用する「サービス」ではなく、必要な「処理」（「この住所をジオコーディングする」など）を指定します。エージェントのコードを変えずにプロバイダーを切り替えられます。
• コストの透明性 — すべての呼び出しについて、使用したサービス、レイテンシ、コストが記録されます。エージェントの支出を正確に把握できます。
• 利用状況から学習 — ヘブ学習により、効果のあるものを強化し、効果のないものを弱めます。ブローカーは日々賢くなります。
• BYOK（独自のキーを使用） — 有料サービスでは、環境変数を通じてお客様の API キーを使用します。キーがない場合、そのサービスは自動的にルーティング対象から除外されます。
• GDPR に準拠 — 記録するのは匿名化されたメタデータのみです。API 呼び出しの内容は保存されません。ネットワーク外にデータを一切送信しないセルフホストのオプションもあります。
• オープンソース — コア MCP サーバーは MIT ライセンスです。コミュニティ主導のアダプターシステムを採用しています。

仕組み

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

エージェントは MCP サーバーとして Hebline に接続します。API を直接呼び出す代わりに、execute、compare、categories の各ツールを使用します。Hebline は利用可能なすべてのサービスを評価し、最適なものを選んで呼び出し、完全なメタデータとともに結果を返します。

利用可能な MCP ツール

ツール	説明
execute	最適なサービスにルーティングして API を呼び出します。結果とメタデータ（サービス、コスト、レイテンシ）を返します。
compare	ある機能に対応するすべての利用可能なサービスとスコアを表示します。選択を確定する前に利用可能なサービスを確認できます。
categories	サポートされているすべての機能と、それぞれに対応するサービスを一覧表示します。

クイックスタート

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 が無料の代替サービスに自動的にルーティングします。

対応サービス

カテゴリ	無料	有料（BYOK）
LLM	Groq（Llama 3.3 70B）、Google Gemini Flash	OpenAI GPT-4o-mini（OPENAI_API_KEY）
ジオコーディング	Nominatim（OpenStreetMap）	Google Maps（GOOGLE_MAPS_API_KEY）
翻訳	MyMemory	DeepL（DEEPL_API_KEY）、LibreTranslate（LIBRETRANSLATE_API_KEY）
ウェブスクレイピング	Fetch Scraper	Firecrawl（FIRECRAWL_API_KEY）
通貨	ExchangeRate-API	Fixer.io（FIXER_API_KEY）
OCR	OCR.space	Google Vision（GOOGLE_VISION_API_KEY）
天気	Open-Meteo	OpenWeatherMap（OPENWEATHERMAP_API_KEY）
ウェブ検索	DuckDuckGo	Brave Search（BRAVE_API_KEY）
ニュース	HackerNews	NewsAPI.org（NEWSAPI_KEY）

9 カテゴリ、20 サービス。 無料サービスは API キー不要ですぐに使えます。ローカルキーが設定されていない場合、LLM は Hebline プロキシ経由でルーティングされます（1 日 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}

内容は記録されず、メタデータのみが記録されます。このデータは、将来のバージョンでヘッブ学習に活用されます。

ロードマップ

• stdio トランスポート対応のコア MCP サーバー
• 重み付きスコアリングルーター
• ジオコーディングアダプター（Nominatim、Google Maps）
• 翻訳アダプター（MyMemory、LibreTranslate、DeepL）
• BYOK キー管理
• 追記専用の呼び出しログ
• GitHub Actions による CI/CD
• ヘッブ学習 — ルーターが呼び出し履歴から学習します
• ホップフィールドネットワークスコアリング（重み付きスコアリングを置き換えます）
• 追加カテゴリ（ウェブスクレイピング、通貨、OCR、メール）
• コミュニティアダプターシステム
• リモートデプロイ向け SSE トランスポート
• コスト分析用ウェブダッシュボード
• 予算アラートと支出上限
• マルチエージェントのコスト按分

コントリビュート

コントリビュートを歓迎します！新しいアダプターの追加は簡単です。ServiceAdapter インターフェースを実装して登録してください。

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

ライセンス

MIT

---

Hebline が開発 — まずは無料のルートを使用し、必要な場合のみ料金を支払います。