AI导哈

API路由优化服务

Hebline MCP Server是一款智能API路由服务，通过最优价格和性能的路由选择，帮助用户降低API调用成本，支持多种API服务类别，包括LLM、地理位置、翻译等。

  • by Hebline
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Hebline/mcp-server

使用说明

Hebline MCP服务器

您的代理商为每一个API呼叫支付过高的费用。我们解决这个问题。

Hebline以适当的价格将每个API调用（包括LLM调用）路由到最佳服务。足够的时候免费。重要的时候付钱。它知道区别。

其他每台路由器都会从您的付费通话中获得利润。把你送到免费的替代品会扼杀他们的收入。 API调用没有余量。永远。

为什么是Hebline？

你的代理人正在赔钱。一个任务触发5-10个不同提供商之间的付费API调用。没有透明度，就没有成本控制。Hebline修复了以下问题：

  • 路线免费优先 --大多数电话不需要最好的模式。Hebline在关键时刻准确学习，并随着市场的变化不断学习。
  • 没有利润。诚实的路线。 --你多付钱，我们就赚不到钱。因此，我们是唯一一款真正为您省钱的路由器。
  • 提供者抽象 --你的经纪人说 什么 它需要（“对这个地址进行地理编码”），而不是 什么服务 使用。在不更改代理代码的情况下交换提供程序。
  • 成本透明度 --每次通话都会记录使用的服务、延迟和成本。确切地知道你的代理人花了多少钱。
  • 从使用中学习 --Hebbian学习加强了有效的东西，削弱了无效的东西。你的经纪人每天都在变得更聪明。
  • 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，而是使用Hebline的工具-- execute, compare，或 categories.Hebline对所有可用服务进行评分，选择最佳服务，进行调用，并返回包含完整元数据的结果。

可用的MCP工具

工具 说明
execute 路由到最佳服务并进行API调用。返回结果+元数据（服务、成本、延迟）。
compare 用分数显示某项功能的所有可用服务。在提交之前，先看看有什么可用的。
categories 列出所有支持的功能及其服务。

快速开始

添加到克劳德桌面

添加 claude_desktop_config.json:

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

添加到克劳德代码

添加 .mcp.json:

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

添加到光标

添加 .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代码（副本）

添加 .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），谷歌Gemini Flash OpenAI GPT-4o-mini(OPENAI_API_KEY)
地理编码 提名（OpenStreetMap） 谷歌地图(GOOGLE_MAPS_API_KEY)
翻译 我的记忆 DeepL(DEEPL_API_KEY)，歌词(LIBRETRANSLATE_API_KEY)
Web抓取 抓取抓取器 Firecrawl(FIRECRAWL_API_KEY)
货币 汇率-API Fixer.io(FIXER_API_KEY)
OCR OCR空间 谷歌视觉(GOOGLE_VISION_API_KEY)
天气 Open Meteo OpenWeatherMap(OPENWEATHERMAP_API_KEY)
网络搜索 DuckDuckGo 勇敢搜索(BRAVE_API_KEY)
新闻 黑客新闻 NewsAPI.org(NEWSAPI_KEY)

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}

不记录任何内容，只记录元数据。这些数据将为未来版本的Hebbian Learning提供支持。

路线图

  • [x] 带stdio传输的核心MCP服务器
  • [x] 加权评分路由器
  • [x] 地理编码适配器（提名、谷歌地图）
  • [x] 翻译适配器（MyMemory、LibreTranslate、DeepL）
  • [x] BYOK密钥管理
  • [x] 仅附加通话记录
  • [x] 带有GitHub操作的CI/CD
  • []Hebbian Learning——路由器从呼叫历史中学习
  • []Hopfield网络评分（取代加权评分）
  • []更多类别（网页抓取、货币、OCR、电子邮件）
  • []社区适配器系统
  • []用于远程部署的SSE传输
  • []用于成本分析的Web仪表板
  • []预算警报和支出限制
  • []多代理成本归因

贡献

欢迎投稿！添加新适配器很简单——实现 ServiceAdapter 接口并注册。

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

许可证

麻省理工学院

由...建造 赫布林 --路线自由第一。只在必要时付款。

相关 MCP