企业官网建设流程全解析

用法：
mcporter [选项]

🔑 核心命令（Core commands）

1. list —— 列出已配置的 MCP 服务器
   （加上 --schema 可查看每个工具的详细说明文档）

• 用法：
  mcporter list [服务器名称] [–schema] [–json]

• 示例：
  mcporter list # 列出所有已配置的 MCP 服务
  mcporter list chrome --schema # 查看 “chrome” 服务提供的所有工具及其参数说明
  mcporter list --json # 以 JSON 格式输出，便于程序解析

2. 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 工具是否工作！

3. auth —— 为某个 MCP 服务器完成 OAuth 授权（不列出工具）
   适用于需要登录（如 Notion、GitHub）但尚未授权的服务

• 用法：
  mcporter auth [–reset]

• 示例：
  mcporter auth notion # 弹出浏览器完成 Notion 登录授权
  mcporter auth notion --reset # 清除已有 token 并重新授权

🛠️ 生成器与开发工具（Generator & tooling）

4. generate-cli —— 生成一个独立的命令行工具（CLI）
   支持 HTTP、stdio 或内联命令，可编译成单文件可执行程序

• 用法：
  mcporter generate-cli --server | --command [选项]

• 示例：
  mcporter generate-cli --server chrome --compile ./my-chrome-cli

  生成一个名为 my-chrome-cli 的独立程序，可直接控制浏览器

5. inspect-cli —— 查看已生成 CLI 的元数据和重新生成指令

• 用法：
  mcporter inspect-cli [–json]

6. emit-ts —— 为某个 MCP 服务器生成 TypeScript 客户端或类型定义

• 用法：
  mcporter emit-ts --mode client|types [选项]

• 用途：方便前端/Node.js 项目集成 MCP 工具

⚙️ 配置管理（Configuration）

7. 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）

8. 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