用法:
mcporter [选项]
🔑 核心命令(Core commands)
- list —— 列出已配置的 MCP 服务器
(加上 --schema 可查看每个工具的详细说明文档)
用法:
mcporter list [服务器名称] [–schema] [–json]示例:
mcporter list # 列出所有已配置的 MCP 服务
mcporter list chrome --schema # 查看 “chrome” 服务提供的所有工具及其参数说明
mcporter list --json # 以 JSON 格式输出,便于程序解析
- call —— 调用某个 MCP 工具
可通过 服务器名.工具名 的方式调用,或直接指定 HTTP 地址;支持 key=value 形式的参数传入
用法:
mcporter call [key=value …]示例:
mcporter call chrome.browse_web url=https://example.com
mcporter call notion.create_page title=“My Note” parent_id=…
✅ 这是最常用的调试命令:无需启动 OpenClaw,直接测试 MCP 工具是否工作!
- auth —— 为某个 MCP 服务器完成 OAuth 授权(不列出工具)
适用于需要登录(如 Notion、GitHub)但尚未授权的服务
用法:
mcporter auth [–reset]示例:
mcporter auth notion # 弹出浏览器完成 Notion 登录授权
mcporter auth notion --reset # 清除已有 token 并重新授权
🛠️ 生成器与开发工具(Generator & tooling)
- generate-cli —— 生成一个独立的命令行工具(CLI)
支持 HTTP、stdio 或内联命令,可编译成单文件可执行程序
用法:
mcporter generate-cli --server | --command [选项]示例:
mcporter generate-cli --server chrome --compile ./my-chrome-cli生成一个名为 my-chrome-cli 的独立程序,可直接控制浏览器
- inspect-cli —— 查看已生成 CLI 的元数据和重新生成指令
- 用法:
mcporter inspect-cli [–json]
- emit-ts —— 为某个 MCP 服务器生成 TypeScript 客户端或类型定义
用法:
mcporter emit-ts --mode client|types [选项]用途:方便前端/Node.js 项目集成 MCP 工具
⚙️ 配置管理(Configuration)
- config —— 查看或编辑 mcporter.json 配置文件
支持添加、删除、导入、登录等操作
子命令:
mcporter config list # 列出所有配置
mcporter config add # 添加新服务器
mcporter config remove # 删除服务器
mcporter config login # 登录(如设置 token)
mcporter config logout # 注销
mcporter config import # 从 Cursor / Claude 等编辑器导入配置示例:
mcporter config add chrome --url http://192.168.0.2:18794/mcp
💡 配置文件默认路径:./config/mcporter.json(也可通过 --config 指定)
🔄 后台守护进程(Daemon)
- daemon —— 管理长期运行的后台服务(用于 stdio 类 MCP 工具)
用法:
mcporter daemon子命令:
- start:启动守护进程
- status:查看状态
- stop:停止
- restart:重启
适用于像 mcp-file-server 这类需要常驻的本地工具。
🌐 全局选项(Global flags)
选项 说明
–config 指定配置文件路径(默认:./config/mcporter.json)
–root 设置 stdio 服务器的工作目录
–log-level 日志级别:debug / info / warn / error(默认 warn)
–oauth-timeout OAuth 浏览器授权超时时间(默认 60000ms = 1 分钟)
🚀 快速开始(Quick start)
mcporter list
查看已配置的 MCP 服务
mcporter list linear --schema
查看 Linear 项目的工具文档
mcporter call linear.list_issues limit:5
调用 Linear 的 “列出 issue” 工具,限制返回 5 条
mcporter generate-cli --command https://host/mcp --compile ./my-cli
基于远程 MCP 服务生成一个独立命令行工具
💡 mcporter 会自动从以下位置加载配置:
- 当前目录下的 ./config/mcporter.json
- 支持的 AI 编辑器(如 Cursor、Claude Desktop、CodeWhisperer 等)的导入配置
✅ 总结:mcporter 是什么?
- 它是一个 通用的 MCP 客户端 CLI 工具,独立于 OpenClaw
- 可用于:
- 测试 Chrome / Notion / GitHub 等 MCP 服务是否正常
- 调试 工具参数(比 OpenClaw 日志更快)
- 生成 独立命令行工具或 TypeScript 客户端
- 管理 多个 MCP 服务的认证和配置
🔗 项目地址(开源):https://github.com/steipete/mcporter