Hebline MCPサーバー

Name: Hebline MCP Server
Author: Hebline

エージェントはすべてのAPI呼び出しで過払いしています。私たちがそれを解決します。

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

他のルーターはすべて、有料の呼び出しからマージンを得ています。無料の代替手段にルーティングすることは、彼らの収益を損なうことになります。API呼び出しにマージンは一切ありません。今後もありません。

なぜHeblineなのか？

エージェントは資金を浪費しています。1つのタスクで、異なるプロバイダー間で5〜10回の有料API呼び出しがトリガーされます。透明性もコスト管理もありません。Heblineはそれを解決します：

無料を優先してルーティング — ほとんどの呼び出しには最高のモデルは必要ありません。Heblineはいつ重要かを正確に学習し、市場の変化に合わせて学習し続けます。
マージンなし。誠実なルーティング。 — 私たちはあなたがより多く支払っても利益を得ません。そのため、実際にコストを削減するために構築された唯一のルーターです。
プロバイダーの抽象化 — エージェントは「どのサービス」を使うかではなく、「何」が必要か（「この住所をジオコーディングして」）を伝えます。エージェントのコードを変更せずにプロバイダーを切り替えることができます。
コストの透明性 — すべての呼び出しは、使用されたサービス、レイテンシ、コストとともにログに記録されます。エージェントが何にいくら使っているかを正確に把握できます。
使用状況から学習 — ヘブ則学習（Hebbian learning）により、機能するものは強化され、機能しないものは弱められます。ブローカーは日々賢くなっていきます。
BYOK (Bring Your Own Key) — 有料サービスは、環境変数を通じてあなたのAPIキーを使用します。キーがない場合、そのサービスはルーティングから自動的に除外されます。
GDPR準拠 — 匿名化されたメタデータのみがログに記録されます。API呼び出しの内容は保存されません。ネットワークからデータが一切出ないセルフホストオプションもあります。
オープンソース — コア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ツール

ツール	説明
`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)
LLMs	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`)
Webスクレイピング	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`)
Web検索	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}

コンテンツはログに記録されず、メタデータのみが記録されます。このデータは将来のバージョンでヘブ則学習を強化します。

ロードマップ

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

貢献

貢献を歓迎します！新しいアダプターの追加は簡単です。ServiceAdapter インターフェースを実装して登録するだけです。

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

ライセンス

MIT

Hebline によって構築されました — 無料を優先してルーティング。必要な時だけ支払います。

Hebline MCP Server