Rhumb

Rhumb MCP Server

面向 Agent 的 Model Context Protocol 工具智能。

三个执行层：原始提供商访问（第 1 层）、智能路由（第 2 层）和确定性组合配方（第 3 层，Beta 阶段，公开目录内容如实呈现）。每个提供商均按 AN Score 评级。每次执行都会生成链式哈希回执。

• 网站：https://rhumb.dev
• 文档：https://rhumb.dev/blog/getting-started-mcp
• 定价：https://rhumb.dev/pricing
• 仓库：https://github.com/supertrained/rhumb

零配置快速入门

发现功能无需受管 API 密钥。 立即安装并启动：

npx -y --package rhumb-mcp@latest rhumb-mcp

或添加到 Claude Desktop / Cursor / 任意 MCP 客户端：

{
  "mcpServers": {
    "rhumb": {
      "command": "npx",
      "args": ["-y", "--package", "rhumb-mcp@latest", "rhumb-mcp"]
    }
  }
}

向你的 Agent 提问：

• “帮我找最适合 Agent 的电子邮件 API”
• “Stripe 的 AN Score 是多少？”
• “检查 Rhumb 是否已发布任何配方”

当前可调用范围

目前，Rhumb 最擅长研究、提取、生成和有限范围的增强。

现阶段应首先将其视为能力基础设施，而非通用业务 Agent 自动化层。第 2 层目前是真正的生产级接口；第 3 层仍处于 Beta 阶段，公开目录有意保持精简。

发现范围大于当前执行范围：Rhumb 为 999 项服务评分，并提供 435 个能力定义，但目前受管执行集中在 28 个可调用提供商。

理解 Resolve 的核心概念

• 服务 = Rhumb 评估和比较的供应商
• 能力 = MCP 客户端可路由并执行的操作
• 配方 = 基于能力构建的确定性多步骤工作流（Beta 阶段，公开目录内容有限）
• 第 2 层是默认路径——发现 → 解析 → 估算 → 执行
• 重复调用的默认身份验证方式 = 受管 API 密钥，或通过 X-Rhumb-Key 预充值的钱包
• 仅当需要控制提供商时，才使用 BYOK 或 Agent Vault
• 仅当需要按次付费且无需注册时，才使用 x402

权威的入门指南：https://rhumb.dev/docs#resolve-mental-model

v2.0.0 的新增内容

Rhumb Resolve——三个执行层：

层级	内容	方式
第 1 层	原始提供商访问	由你选择提供商。作为备用通道和信任锚点。
第 2 层	能力路由	Rhumb 根据 AN Score、可用性／熔断器状态、预估成本、延迟代理指标、凭据模式和明确的策略约束，为此次调用路由至最合适的受支持提供商。
第 3 层	确定性配方（Beta）	编译后的 DAG 工作流。支持多步骤、预算强制执行和内容防火墙。目前尚未发布任何配方。

新增基础设施：

• 执行回执（链式哈希、HMAC 签名）
• 路由说明（解释选择该提供商的原因）
• AN Score 结构分离（只读缓存，可审计）
• 计费事件流（链式哈希，包含 15 种以上事件类型）
• 信任仪表板所需的数据，包括观测到的可用性、成本和可靠性
• 配方安全控制（内容防火墙、幂等性、嵌套深度、扇出速率限制）
• 紧急停用开关（按 Agent、提供商、配方分别控制；全局开关需通过身份验证的双人授权）
• 审计跟踪（仅追加、链式哈希验证、导出 API）

从 0.x 迁移

• 所有 v1 端点均完全向后兼容——没有破坏性变更
• 新的 v2 端点与 v1 端点并存
• execute_capability 现在会返回包含归属信息和回执的 _rhumb_v2 元数据
• 新增用于检查配方目录、回执和遥测数据的工具
• 更新：npx -y --package rhumb-mcp@latest rhumb-mcp

发现工具（无需认证，共 6 个工具）

工具	功能
find_services	根据需求搜索已编入索引的服务
get_score	查看某项服务的完整 AN 评分细目：执行质量、访问就绪度、自主级别、层级标签和新鲜度
get_alternatives	查找备选服务，并按 AN 评分排序
get_failure_modes	查看服务已知的故障模式、影响严重程度和解决方法
discover_capabilities	按领域浏览能力，或按文本搜索
resolve_capability	给定能力 ID，并可选指定凭据模式，返回按排名排列的提供商及其健康状态、每次调用成本、认证方式、端点模式、执行指南，以及机器可读的恢复字段，例如 recovery_hint.resolve_url、recovery_hint.credential_modes_url，以及（如适用）recovery_hint.alternate_execute_hint 或 recovery_hint.setup_handoff；如果能力 ID 有误，还会提供拼写错误恢复信息

执行工具（需要认证，共 8 个）

{
  "mcpServers": {
    "rhumb": {
      "command": "npx",
      "args": ["-y", "rhumb-mcp@latest"],
      "env": {
        "RHUMB_API_KEY": "rk_your_key_here"
      }
    }
  }
}

在 https://rhumb.dev/auth/login 获取受治理的 API 密钥（支持 GitHub、Google 或电子邮件，30 秒即可完成）。

工具	功能
execute_capability	通过 Rhumb Resolve 调用某项能力
estimate_capability	在调用能力前估算当前执行路径、成本和健康状态；匿名直连的事实记录系统路径也会保留机器可读的 execute_readiness 交接信息
credential_ceremony	获取服务 API 凭据的分步说明
check_credentials	检查凭据模式就绪情况，可检查全局状态或特定能力
rhumb_list_recipes	列出当前已发布的 Rhumb Layer 3 配方目录
rhumb_get_recipe	获取 Rhumb 配方的完整已发布定义，包括输入／输出架构和步骤拓扑
rhumb_recipe_execute	公共目录中上线配方后，执行一次已发布的 Rhumb Layer 3 配方
get_receipt	按 ID 检索执行回执

财务工具（需要认证，共 5 个）

工具	功能
budget	查看或设置调用支出限额
spend	获取某个计费周期的支出明细：已花费的美元总额、调用次数、每次调用的平均成本，以及按能力和提供商划分的明细
check_balance	查看当前 Rhumb 账户的美元余额
get_payment_url	获取结账网址，为 Rhumb 余额充值
get_ledger	查看计费历史：扣款、充值和自动续充事件

运维工具（需要认证，共 2 个）

工具	功能
routing	查看或设置 Rhumb 在未于 execute_capability 中指定提供商时自动选择提供商的方式
usage_telemetry	获取执行分析数据——Rhumb 使用情况的调用次数、延迟、错误、成本和提供商健康状态

21 个 MCP 工具

发现（免费）： find_services、get_score、get_alternatives、get_failure_modes、discover_capabilities、resolve_capability

执行（需认证）： execute_capability、estimate_capability、credential_ceremony、check_credentials、rhumb_list_recipes、rhumb_get_recipe、rhumb_recipe_execute、get_receipt

财务（需认证）： budget、spend、check_balance、get_payment_url、get_ledger

运维（需认证）： routing、usage_telemetry

发现功能覆盖 999 项已评分服务，但当前受治理的执行功能覆盖 28 个可调用提供商。

当前最适用的场景：研究、提取、生成和有限范围的信息补充。通用业务 Agent 自动化属于未来规划，并非当前承诺支持的可调用功能。

常见工作流

1）发现工具（无需认证）

“我需要一个适用于 Agent 的电子邮件提供商。”

• find_services → 搜索服务全貌
• get_score → 检查特定提供商
• get_failure_modes → 查看实际使用中会出现的问题

2) 路由能力（无需身份验证）

“我需要 email.send。应该使用什么？”

• discover_capabilities → 查找能力 ID
• resolve_capability → 获取按排名排序的提供方、可选的凭证模式筛选、机器可读的恢复字段（例如 recovery_hint.resolve_url、recovery_hint.credential_modes_url，以及适用时的 recovery_hint.alternate_execute_hint 或 recovery_hint.setup_handoff），或在能力 ID 错误时获取搜索建议

3) 检查就绪状态（需要身份验证）

“我现在可以调用 deployment.list 吗？应该走哪条执行通道？”

• check_credentials → 不带参数调用，以检查账户范围内已配置的 BYOK/直接套餐就绪状态；或传入一项能力，以检查提供方级别的模式状态和认证流程是否可用

4) 执行（需要身份验证）

“使用高于我的质量门槛且最便宜的提供方发送这封电子邮件。”

• estimate_capability → 执行前检查当前执行通道、健康状况和成本
• execute_capability → 执行操作
• get_receipt → 验证 HMAC 签名的执行记录

5) 检查配方是否可用／运行配方（需要身份验证）

“是否已经有已发布的 Rhumb 工作流可以完成这项任务？”

• rhumb_list_recipes → 检查公共目录中实际已上线的内容
• rhumb_get_recipe → 仅在配方出现在目录中后检查该配方
• rhumb_recipe_execute → 配方发布后运行编译好的配方
• 公共说明：Layer 3 目录目前内容稀少／为空，因此当下大多数实际工作应使用 Layer 2 能力

x402 微支付

无需账户——使用 USDC on Base 按调用付费：

{
  "env": {
    "RHUMB_X402_WALLET_ADDRESS": "0x...",
    "RHUMB_X402_PRIVATE_KEY": "0x..."
  }
}

本地开发

cd packages/mcp
npm ci
npm run dev

测试和构建

npm test          # 84+ tests
npm run type-check
npm run build

相关链接

• API：https://api.rhumb.dev/v1（v1 兼容）/ https://api.rhumb.dev/v2（Resolve v2）
• npm：https://www.npmjs.com/package/rhumb-mcp
• MCP Registry：https://registry.modelcontextprotocol.io（搜索“rhumb”）
• GitHub：https://github.com/supertrained/rhumb

许可证

MIT