HopBase

HopBase MCP 服务

HopBase 是一个 AI 网关，可通过一个基础 URL 提供 Claude、GPT、Gemini、DeepSeek 及其他文本、图像和视频模型。此 MCP 服务可让编码 Agent 查询其 HopBase API 密钥的功能：可调用哪些模型、这些模型的限制、账户余额和使用情况。

• 端点： https://api.hop-base.com/mcp
• 传输方式： Streamable HTTP，无状态，仅支持 POST（每个请求包含一条 JSON-RPC 消息；不支持 SSE 流或批量请求）
• 身份验证： Authorization: Bearer <key> 或 x-api-key: <key>，使用与调用模型时相同的 API 密钥。调用工具时必须提供密钥；列出工具无需密钥
• 范围： 只读；每项结果仅涵盖当前使用的密钥

这是一项托管服务，尚未公开其源代码。本仓库包含 MCP 注册表清单（server.json）和客户端配置。

工具

工具	返回内容
list_models	此密钥可调用的模型及其实际价格
get_model_limits	对于一个模型 ID：此密钥能否调用该模型，以及文档中记载的端点、请求参数和限制，并附有源页面链接
search_docs	与查询（模型 ID、参数名称、错误代码）最匹配的文档章节，每项附带 URL 和摘要；lang 可选择 en、zh-cn、zh-tw、es 或 ja
get_balance	账户余额和此密钥的支出上限使用情况，单位为 USD
get_key_info	密钥名称、分组、支出上限、并发上限、有效期和状态
get_usage	此密钥的请求数、令牌数和计费金额；默认查询最近 7 天，最长可查询 92 天

get_model_limits 和 search_docs 会读取已发布的文档，最多每小时刷新一次。链接指向的文档页面具有权威性：结果中未列出某项限制，并不代表没有此限制。

设置

你需要一个 HopBase API 密钥：在控制台中创建密钥，并将其导出为 HOPBASE_API_KEY。

Claude Code

claude mcp add --transport http hopbase https://api.hop-base.com/mcp \
  --header "Authorization: Bearer $HOPBASE_API_KEY"

运行命令时，shell 会展开变量，因此密钥会保存在本地 Claude Code 配置中。若要配置共享项目，请改为将 examples/claude-code.mcp.json 放入项目并命名为 .mcp.json；Claude Code 会在启动时展开 ${HOPBASE_API_KEY}，因此文件中不会保存密钥。

Cursor

将 examples/cursor.mcp.json 保存为项目中的 .cursor/mcp.json，或保存为 ~/.cursor/mcp.json 以供所有项目使用：

{
  "mcpServers": {
    "hopbase": {
      "url": "https://api.hop-base.com/mcp",
      "headers": { "Authorization": "Bearer ${env:HOPBASE_API_KEY}" }
    }
  }
}

其他客户端

任何支持带自定义标头的远程 Streamable HTTP 服务的客户端都可以连接：将其指向该端点，并发送上述 Authorization 标头。

了解须知

• MCP 可见的内容由密钥决定。 list_models 和 get_model_limits 只能查看所配置密钥所属的分组。若要查看其他模型系列，请将相应分组添加到密钥中，或使用包含该分组的密钥注册另一个服务条目。
• 模型调用不会经过 MCP。 请通过常规 API 端点（https://api.hop-base.com/v1：OpenAI Chat Completions 和 Responses、Anthropic Messages、原生 Gemini，以及图像和视频任务端点）进行推理。
• 调用工具需要密钥。 握手（initialize）和 tools/list 无需凭证即可响应，因此客户端和目录可以发现这些工具；不带密钥调用 tools/call 会返回 401。

链接

• 编码 Agent 指南和 MCP 文档：https://hop-base.com/en/docs/getting-started/ai-agent
• 文档：https://hop-base.com/en/docs
• 机器可读的集成规范：https://hop-base.com/llms.txt
• 支持：[email protected]

许可证

本仓库中的文件根据 MIT 许可证发布。