Hebline Mcp Server Any Api Broker

Hebline MCP Server

你的 Agent 每次 API 调用都花了冤枉钱。我们来解决这个问题。

Hebline 会将每次 API 调用（包括大模型调用）路由到价格合适的最佳服务。够用时免费，关键时刻付费。它懂得其中的区别。

其他所有路由器都会从你的付费调用中赚取差价。把你路由到免费替代服务会损害他们的收入。我们绝不从你的 API 调用中赚取差价。

为什么选择 Hebline？

你的 Agent 正在不断烧钱。一项任务会触发 5–10 次来自不同提供商的付费 API 调用。既不透明，也无法控制成本。Hebline 可以解决这些问题：

• 优先路由到免费服务 — 大多数调用不需要最好的模型。Hebline 会精准判断何时需要更好的模型，并随着市场变化持续学习。
• 不赚差价，诚实路由。 — 你多花钱，我们不会多赚钱。因此，我们是唯一一个真正致力于帮你省钱的路由器。
• 提供商抽象 — 你的 Agent 只需说明需要做什么（“对这个地址进行地理编码”），而不必指定使用哪项服务。无需更改 Agent 代码即可更换提供商。
• 成本透明 — 每次调用都会记录所用服务、延迟和成本，准确了解 Agent 的支出。
• 从使用情况中学习 — 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

你的 Agent 会将 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）
大模型	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 密钥。未设置本地密钥时，大模型调用会通过 Hebline 代理路由（每天 50 次免费调用）。

示例

Agent 提出请求：“对柏林的勃兰登堡门进行地理编码”

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

Agent 获得了坐标，知道这次调用是免费的，而 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。

路线图

• 核心 MCP 服务，支持 stdio 传输
• 加权评分路由器
• 地理编码适配器（Nominatim、Google Maps）
• 翻译适配器（MyMemory、LibreTranslate、DeepL）
• BYOK 密钥管理
• 仅追加的调用日志
• 使用 GitHub Actions 实现 CI/CD
• Hebbian Learning——路由器从调用历史中学习
• Hopfield 网络评分（替代加权评分）
• 更多类别（网页抓取、货币、OCR、电子邮件）
• 社区适配器系统
• 用于远程部署的 SSE 传输
• 用于成本分析的 Web 仪表板
• 预算提醒和支出限额
• 多 Agent 成本归因

贡献

欢迎贡献！添加新适配器很简单——只需实现 ServiceAdapter 接口并注册即可。

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

许可证

MIT

---

由 Hebline 构建——优先选择免费方案，仅在必要时付费。