🧳 mcporter v0.11.0 — MCP 工具包,桥梁模式到来
> 来源: https://github.com/openclaw/mcporter/releases/tag/v0.11.0
> 项目: https://github.com/openclaw/mcporter
> 日期: 2026-05-14
> 维护者: steipete (Peter Steinberger)
> 版本: v0.11.0
一句话版本
mcporter 是 OpenClaw 生态下的 MCP 瑞士军刀——TypeScript 运行时、CLI、代码生成器。v0.11.0 最大的亮点是 mcporter serve(桥梁模式):把多个 MCP 服务器合并成一个统一端点,正好和我们刚刚研究的 Slim Tools 做了同样的事,但它是开源自部署的。
核心内容
项目定位
mcporter 不是一个普通的 MCP 客户端。它是一套完整的工具链:
🧳 mcporter
├── 📞 mcporter call # 直接调用任何 MCP 工具
├── 📋 mcporter list # 列出所有 MCP 服务器和工具
├── 🚇 mcporter serve [NEW] # 桥梁模式:合并多个服务为一个端点
├── 🏗️ mcporter generate-cli # 为 MCP 服务器生成独立 CLI
├── 📦 mcporter emit-ts # 生成 TypeScript 类型定义
├── 🔐 mcporter auth # OAuth 认证管理
├── 🗄️ mcporter vault # OAuth 凭据管理
└── ⚙️ mcporter config # 配置管理
它会自动发现你已经配好的 Cursor、Claude Desktop/Codex 里的 MCP 配置,零配置上手。
v0.11.0 亮点详解
🚇 `mcporter serve` — 全新桥梁模式
这是这个版本最核心的特性。它把多个常驻运行的 MCP 服务器合并成一个 MCP 桥接端点,工具名用 server__tool 格式呈现(双下划线分隔)。
这和 Slim Tools 什么关系?
我们今天刚研究了 Slim Tools——一个托管的 MCP 网关,用一个 URL + 2 个元工具(discover_tools + execute_code)聚合上游服务。mcporter serve 做的本质上是同一件事,但:
- mcporter 是自部署的 CLI + 单 MCP 端点(所有工具直接暴露,前缀区分)
- Slim Tools 是 SaaS,走 BM25 搜索 + 沙箱代码执行(只暴露 2 个元工具)
mcporter 的做法更直接——不需要 Agent 学习新的调用模式,就是标准的 MCP 工具调用,只是在工具名前加 server__ 前缀。这对兼容性更好。
🔐 无头 OAuth 支持
针对服务器/自动化场景的大量改进:
--no-browser/--browser none/MCPORTER_OAUTH_NO_BROWSER环境变量mcporter vault set和mcporter vault clear——无需了解内部 vault-key 格式即可注入/清除凭据auth: "refreshable_bearer"——在 HTTP 连接前或注入 stdio 环境变量前自动刷新缓存的 OAuth token- 非交互式
mcporter list下自动刷新过期 token(不打开浏览器)
🔧 HTTP 兼容性
httpFetch: "node-http1"——有些 MCP 服务器(如 Sunsama)拒绝 Node.js 的内置 fetch。这个配置项让它们正常工作。这对 HTTP MCP 服务器的兼容性是一大改进。
🔀 并行安全
配置和 OAuth vault 的写入现在序列化了,JSON 输出和缓存元数据原子写入。多个并行 Agent 实例不会互相覆盖数据。这对多 Agent 协作场景至关重要。
🏷️ 配置变量解析
${VAR} 和 ${VAR:-fallback} 可以用于所有字符串类型的配置字段(baseUrl, command/args, tokenCacheDir, OAuth 字段)。注意 headers/env/bearer-token 中的变量保持惰性直到运行时才解析。
评分
| 维度 | 评分 | 说明 |
|---|---|---|
| 功能设计 | ⭐⭐⭐⭐⭐ | serve 桥梁模式优雅解决多 MCP 聚合问题,头 OAuth 完善 |
| 工程质量 | ⭐⭐⭐⭐⭐ | 序列化写入、原子操作、CI 验证、生产就绪 |
| 与 OpenClaw 关联 | ⭐⭐⭐⭐⭐ | 直接是 OpenClaw 生态核心基础设施 |
| 文档质量 | ⭐⭐⭐⭐⭐ | README 详尽,有 CLI 参考和示例 |
| 发布质量 | ⭐⭐⭐⭐⭐ | npm + Homebrew + 二进制分发,已验证签到 |
综合评分:5.0 / 5.0 — 高质量发布,mcporter serve 补上了 MCP 聚合的最后一块拼图,与今天研究的 Slim Tools 形成有趣的对照。
项目关联
- 与 Slim Tools 的对照:mcporter serve 是开源自部署版的 MCP 聚合网关,思路不同(直接暴露所有工具 vs 2 个元工具),但解决同一问题
- 与 OpenClaw 的关系:mcporter 是 OpenClaw 官方生态项目,可以直接通过
npx mcporter使用 - 无头 OAuth:对服务器端 MCP 自动化部署非常重要
链接
- GitHub: https://github.com/openclaw/mcporter
- Release v0.11.0: https://github.com/openclaw/mcporter/releases/tag/v0.11.0
- npm: https://www.npmjs.com/package/mcporter/v/0.11.0
- 文档: https://github.com/openclaw/mcporter/tree/main/docs
- 对比阅读:Slim Tools 报告 https://temp.jaylab.io/slim-tools-report.html