七、工具调用语法mcporter 支持多种参数风格适应不同场景7.1 推断调用命令最简洁# 点号分隔自动触发 call 命令mcporterserver.toolkeyvalue key:value# 带空格的值用引号包裹mcporterserver.toolkey: multi word value7.2 显式 call 标志mcporter callserver.tool--flagvalue mcporter callserver.toolkeyvalue--flagvalue7.3 函数调用语法最直观# 完整函数调用风格mcporter callserver.tool(key: value, key2: value2)# 位置参数省略标签时按 Schema 顺序映射mcporterserver.tool(positional1, positional2)支持嵌套对象和数组mcporter calllinear.create_issue(title: Bug, assignee: {name: Alice}, labels: [bug, urgent])7.4 从文件读取参数# 将文件内容作为参数值mcporter callserver.toolbodyfile.md mcporter callserver.tool--bodyfile.md7.5 输出格式选择mcporter callserver.tool--outputtext# 纯文本mcporter callserver.tool--outputmarkdown# Markdownmcporter callserver.tool--outputjson# JSON机器可读mcporter callserver.tool--outputraw# 原始输出--json在 stdout 生成稳定 JSON 信封人类可读的进度、提示和警告始终输出到 stderr。八、Ad-hoc 临时连接无需编辑配置文件即可指向任何 MCP 端点——这是 mcporter 最强大的特性之一。8.1 HTTP 临时连接# 通过 --http-url 列出工具mcporter list --http-url https://mcp.example.com/mcp# 通过 --http-url 调用工具mcporter call --http-url https://mcp.example.com/mcptoolkeyvalue# 裸 URL 自动解析mcporter 自动识别 MCP 端点mcporter listhttps://mcp.example.com/mcpmcporter callhttps://mcp.example.com/mcp.tool(key: value)8.2 Stdio 临时连接# 直接运行本地 stdio 服务器mcporter call--stdiobun run ./server.ts--namelocal-tools scrapeurlhttps://example.com# 使用 npx 运行社区服务器mcporter list--stdionpx -y modelcontextprotocol/server-filesystem--namefs8.3 安全机制场景行为非 HTTPS 端点需要--allow-http或--insecure首次遇到新 stdio 命令打印确认摘要临时连接持久化使用--persist保存到配置文件8.4 OAuth 自动检测 浏览器 MCP 服务器⚙️ mcporter 用户 浏览器 MCP 服务器⚙️ mcporter 用户自动检测需要 OAuthmcporter call https://mcp.example.com/mcp.tool初始握手无令牌401/403 Unauthorized打开浏览器登录页面展示登录/授权界面登录并授权返回授权码交换令牌访问令牌重试原始调用带令牌工具响应输出结果当临时 HTTP 服务器在初始握手期间返回401/403mcporter 自动将定义提升为 OAuth 并启动浏览器流程。无头主机使用--no-browser打印授权 URL。九、Keep-Alive 守护进程9.1 为什么需要 Keep-Alive许多 MCP 服务器是有状态的如 Chrome DevTools、Playwright、数据库连接。如果每次 CLI 调用都启动新进程状态会丢失性能也很差。Keep-Alive 守护进程在后台保持这些连接温热后续调用直接复用。9.2 生命周期选择{ mcpServers: { browser: { command: npx, args: [-y, chrome-devtools-mcplatest, --autoConnect], lifecycle: keep-alive } } }默认行为服务器类型默认生命周期Chrome DevTools MCPkeep-aliveMobile MCPkeep-alivePlaywright MCPkeep-aliveCloudBase MCPkeep-alive其他服务器ephemeral需显式配置环境变量覆盖变量说明MCPORTER_KEEPALIVEname按名称启用 keep-alive逗号分隔*表示全部MCPORTER_DISABLE_KEEPALIVEname按名称禁用 keep-alive9.3 守护进程命令mcporter daemon status# 查看状态mcporter daemon start# 启动mcporter daemon restart# 重启mcporter daemon stop# 停止符合条件的服务器在需要时自动启动守护进程。使用显式命令进行检查、预热、重启或停止。9.4 守护进程架构 客户端 Keep-Alive 守护进程Unix 域套接字本地通信连接管理器Chrome DevToolsPlaywright数据库连接mcporter listmcporter callClaude Code通过 mcporter serve9.5 日志管理# 启动守护进程并记录日志mcporter daemon start--log# 指定日志文件mcporter daemon start--log--log-file /path/to/log# 限制日志范围mcporter daemon start--log--log-servers chrome-devtools,playwright设置MCPORTER_LOG_LEVELinfo查看结构化连接决策日志。