AI导哈

AI工作流优化服务器

RelayPlane MCP Server是一款用于减少多步骤AI工作流中上下文使用量的服务，通过将中间结果保留在工作流引擎中而非通过上下文窗口传递，可节省90%以上的令牌使用并降低成本。

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

使用说明

中继平面MCP服务器

在多步骤工作流程中将AI上下文使用率降低90%以上

RelayPlane将中间结果保存在工作流引擎中，而不是通过上下文窗口传递，从而节省令牌并降低成本。

目录

快速开始

1.使用API键安装（推荐）

claude mcp add relayplane \
  -e OPENAI_API_KEY=sk-... \
  -e ANTHROPIC_API_KEY=sk-ant-... \
  -- npx @relayplane/mcp-server

2.重新启动克劳德代码

重要提示： 添加MCP服务器后，您必须完全重新启动Claude Code。这 /mcp 命令只重新连接，它不会重新加载环境变量。

3.测试连接

问克劳德： “使用relay_models_list显示已配置的提供程序”

模型应显示 configured: true 对于具有有效API密钥的提供程序。

安装选项

选项A:内联API键（最简单）

claude mcp add relayplane \
  -e OPENAI_API_KEY=sk-proj-... \
  -e ANTHROPIC_API_KEY=sk-ant-... \
  -e GOOGLE_API_KEY=AIza... \
  -e XAI_API_KEY=xai-... \
  -- npx @relayplane/mcp-server

选项B:Shell环境变量

首先，添加到您的shell配置文件中(~/.zshrc 或 ~/.bashrc):

export OPENAI_API_KEY=sk-proj-...
export ANTHROPIC_API_KEY=sk-ant-...
export GOOGLE_API_KEY=AIza...
export XAI_API_KEY=xai-...

然后获取并安装：

source ~/.zshrc
claude mcp add relayplane -- npx @relayplane/mcp-server

选项C：手动配置

编辑 ~/.claude.json 直接：

{
  "projects": {
    "/your/project/path": {
      "mcpServers": {
        "relayplane": {
          "type": "stdio",
          "command": "npx",
          "args": ["@relayplane/mcp-server"],
          "env": {
            "OPENAI_API_KEY": "sk-proj-...",
            "ANTHROPIC_API_KEY": "sk-ant-...",
            "GOOGLE_API_KEY": "AIza...",
            "XAI_API_KEY": "xai-..."
          }
        }
      }
    }
  }
}

警告： 这 env 字段必须包含实际的API键，而不是像这样的变量引用 ${OPENAI_API_KEY}MCP配置文件中不支持变量替换。

型号ID

重要提示： 始终检查https://relayplane.com/docs/providers获取最新型号ID。这 relay_models_list 工具可能会返回过时的信息。

OpenAI——前缀： openai:

型号ID 最适合
gpt-5.2 最新旗舰，1M背景
gpt-5-mini 经济高效、快速
gpt-5-nano 超快速，成本最低
o3迷你 推理任务

Anthropic——前缀： anthropic:

型号ID 最适合
claude-opus-4-5-20251101 最智能、最复杂的任务
claude-sonnet-4-5-20250929 最佳编码，对代理最强
claude-haiku-4-5-20251001 快速、高容量的任务
claude-3-5-haiku-20241022 快速、实惠（传统）

谷歌——前缀： google:

型号ID 最适合
gemini-3-pro 最强大的多模式
gemini-3-flash 快速多模式
gemini-2.5-flash 经济高效

xAI--前缀： xai:

型号ID 最适合
grok beta 最新旗舰，256K上下文

示例用法

{
  "name": "my-step",
  "model": "openai:gpt-5.2",
  "prompt": "Analyze this data..."
}

可用工具

工具 目的 成本
relay_run 单提示符执行 每个令牌
relay_workflow_run 多步骤编排 每个令牌
relay_workflow_validate 验证DAG结构 免费
relay_skills_list 列出预构建模式 免费
relay_models_list 列出可用型号 免费
relay_runs_list 查看最近的跑步记录 免费
relay_run_get 获取跑步详情 免费

预算保护

默认保护措施（可通过CLI标志进行自定义）：

限制 默认值 标志
每日支出 5.00 --每日最高成本
每次通话费用 $0.50 --单次通话最高费用
每小时请求数 100 --每小时最大呼叫数

RelayPlane是BYOK（自带密钥）-我们不收取API使用费。费用仅反映您的供应商账单。

预置技能

使用 relay_skills_list 要查看可用的工作流模板，请执行以下操作：

技能 上下文简化 用例
发票处理者 97% 提取、验证、汇总发票
内容管道 90% 生成和细化内容
铅富集 80% 丰富联系人数据

配置

持久配置文件

创建 ~/.relayplane/mcp-config.json:

{
  "codegenOutDir": "./servers/relayplane",
  "maxDailyCostUsd": 10.00,
  "maxSingleCallCostUsd": 1.00,
  "maxCallsPerHour": 200
}

注： API密钥应通过环境变量或Claude Code MCP传递 env 字段--未存储在此配置文件中。

故障排除

“提供程序未配置”错误

Provider "openai" (step "extract") is not configured.
Set OPENAI_API_KEY environment variable.

原因：

  1. API密钥未传递到MCP服务器
  2. 配置更改后Claude代码未重新启动

解决：

  1. 检查您的MCP配置 ~/.claude.json:
"relayplane": {
  "env": {
    "OPENAI_API_KEY": "sk-..."  // Must be actual key, not ${VAR}
  }
}

  1. 完全重新启动Claude Code（退出 Ctrl+C，重新启动）

  2. 验证配置： 问克劳德： “使用relay_models_list并检查哪个显示已配置：true”

未找到型号（404错误）

Anthropic API error: 404 - model: claude-3-5-sonnet-20241022

原因： 型号ID已过时或不正确。

解决方案： 在以下位置检查当前型号ID： https://relayplane.com/docs/providers

常见修复：

  • 使用 claude-sonnet-4-5-20250929 最新克劳德·十四行诗
  • 使用 gpt-5.2 获取最新的OpenAI旗舰型号

配置更改未生效

原因： /mcp 重新连接不会重新加载环境变量。

解决方案： 完全重新启动Claude代码：

  1. 退出 Ctrl+C
  2. 重新启动 claude
  3. 跑 /mcp 验证连接

工作流验证通过但执行失败

原因： relay_workflow_validate 仅检查DAG结构，不：

  • API密钥有效性
  • 型号可用性
  • 架构兼容性

解决方案： 用简单的测试 relay_run 第一：

Use relay_run with model "openai:gpt-5.2" and prompt "Say hello"

快速测试

设置后，验证一切正常：

Use relay_workflow_run to create an invoice processor:
- Step 1 (extract): Use openai:gpt-5.2 to extract vendor, total from invoice
- Step 2 (validate): Use anthropic:claude-haiku-4-5-20251001 to verify math

Input: "Invoice from Acme Corp, Total: $500"

预期：两个步骤均已成功完成，并具有结构化输出。

支持

  • 文档： https://relayplane.com/docs
  • 型号ID: https://relayplane.com/docs/providers
  • 问题： https://github.com/RelayPlane/mcp-server/issues

许可证

麻省理工学院

相关 MCP