前言¶
在 Agent 里接 MCP，常见路径是在 IDE 或客户端里逐个配服务器、等图形界面刷新工具列表，再靠对话间接调用。排查某个工具是否可用、改认证或临时起一个 stdio 服务时，往往缺少一条可脚本化、可复现的命令线入口。
下面介绍 SkillHub 上的 Mcporter（坐标 @clawhub_steipete/mcporter）：它把 mcporter 这一套 CLI 能力写进 Agent Skill，让模型在对话中按文档去列出、配置、认证和直接调用 MCP 服务器与工具，覆盖 HTTP 与 stdio 两种传输方式。
这是什么¶
Mcporter 是面向开发编程场景（SkillHub 分类 dev-programming）的 Skill，版本 1.0.0，来源为 clawhub，发布者为 steipete，上游页面在 ClawHub。SkillHub 镜像页：Mcporter @ SkillHub。
一句话定位：通过 mcporter CLI 直接与 MCP 交互——列服务与工具、改配置、做 OAuth、调用工具，并支持临时服务器、守护进程以及 CLI/TypeScript 代码生成。标签标明 requires_api_key=false，即 Skill 本身不强制额外 API Key（具体 MCP 服务仍可能有自己的认证要求）。
维护者在上游 ClawHub 标注为 Peter Steinberger（@steipete）。
核心功能¶
以下能力均来自上游 Skill 说明，按用途归纳：
- 发现与查看：列出已配置的 MCP 服务器与工具，并可带 schema 查看结构。
- 调用工具：支持多种选择器写法（
server.tool、函数式参数、完整 HTTP URL、stdio 子进程），以及 JSON 参数体。 - 认证与配置：OAuth 流程；对
mcporter.json做 list/get/add/remove/import，以及 login/logout。 - 守护进程：启动、查看状态、停止、重启 mcporter daemon。
- 代码生成：从指定 server 或 command 生成 CLI；检查生成结果；按 client/types 模式输出 TypeScript。
传输层明确支持 HTTP 与 stdio；说明中还提到可针对 临时（ad-hoc）服务器 操作，适合本地调试未写入长期配置的进程。
安装与启用¶
SkillHub
- 页面：https://www.skillhub.cn/skills/clawhub_steipete/mcporter
- 坐标：
@clawhub_steipete/mcporter - 官方聚合入口：https://api.skillhub.cn/zcwl/mcporter
在 SkillHub 或你所用的 Agent 产品中，按平台提供的「从坐标安装 Skill」流程引用上述坐标即可（具体菜单名称因产品而异，以 SkillHub 当前页面为准）。
上游 ClawHub / OpenClaw
上游给出的安装示例为：
openclaw skills install @steipete/mcporter
安装 Skill 之后，本机仍需能执行 mcporter 命令（CLI 由 mcporter 项目提供，Skill 负责教 Agent 如何正确使用这些命令）。默认配置文件路径为 ./config/mcporter.json，可用 --config 覆盖。
Cursor、Codex CLI、Claude Code 等对 Skill 的安装路径与启用开关各不相同；本文仅记录 SkillHub 坐标与上游 openclaw 示例，产品内步骤请以各产品文档为准。
典型用法¶
先做环境确认：在终端能运行 mcporter，且 Skill 已在 Agent 中启用。之后可按下面顺序操作（示例均来自上游文档）。
快速浏览
mcporter list
mcporter list --schema
mcporter call <server.tool> key=value
调用工具的几种写法
mcporter call linear.list_issues team=ENG limit:5
mcporter call "linear.create_issue(title: \"Bug\")"
mcporter call https://api.example.com/mcp.fetch url:https://example.com
mcporter call --stdio "bun run ./server.ts" scrape url=https://example.com
mcporter call <server.tool> --args '{"limit":5}'
认证与配置
mcporter auth
mcporter auth --reset
mcporter config list
mcporter config get
mcporter config add
mcporter config remove
mcporter config import
mcporter config login
mcporter config logout
守护进程
mcporter daemon start
mcporter daemon status
mcporter daemon stop
mcporter daemon restart
代码生成与检查
mcporter generate-cli --server <name>
mcporter generate-cli --command <cmd>
mcporter inspect-cli
mcporter inspect-cli --json
mcporter emit-ts --mode client
mcporter emit-ts --mode types
需要给脚本或 Agent 解析时，上游建议优先加上 --output json，以便得到机器可读结果。
经过上面的步骤，你可以在不改 IDE MCP 面板的情况下，用同一套命令验证工具、批量改配置或对接 CI。
适用场景与注意¶
适合谁
- 需要在终端或自动化流水线里直接调 MCP 工具，而不是只通过聊天间接调用的人。
- 同时维护 HTTP 远程 MCP 与 本地 stdio 服务（例如
bun run ./server.ts）的开发者。 - 希望从现有 MCP 服务生成 CLI 或 TypeScript 类型/客户端，减少手写胶水代码的团队。
限制与注意
- Skill 教的是 mcporter CLI 的用法；若本机未安装 mcporter，仅安装 Skill 无法执行命令。
- OAuth 与
config子命令会改动本地配置与登录状态，在共享机器或 CI 里应使用独立--config路径，避免覆盖个人环境。 - stdio 示例依赖你本地的运行时（如文档中的
bun）；命令中的服务器路径与工具名需与你实际 MCP 实现一致。 - SkillHub 统计（评分、下载、安装次数）会随时间变化；撰写时页面显示为高分与数万级下载量级，以 SkillHub 技能页 实时数据为准。
结尾¶
Mcporter Skill 把 MCP 的「列、配、认证、调用」收敛到 mcporter 一条 CLI 上，并覆盖配置编辑、守护进程与代码生成，适合把 MCP 集成进日常开发与自动化。需要安装或查看说明时，可从 SkillHub 坐标 @clawhub_steipete/mcporter 或上游 https://clawhub.ai/steipete/mcporter 进入。
