用法：
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