MCP 工具调用器

要解决什么问题

在 Agent 或本地开发里，MCP（Model Context Protocol）服务往往通过 IDE 或宿主进程暴露工具；当你只想在终端里试一条调用、写脚本批量拉数据，或把某个 server 固化成可复用的子命令时，缺少一个与 MCP 协议对齐、又足够轻量的 CLI 会很别扭。

mcporter 就是面向这类场景的命令行入口：不绕宿主 UI，直接对 MCP server 发工具调用，并顺带处理认证与本地配置。

核心能力与用法

• 调用工具：支持多种入参写法——选择器式（如 mcporter call linear.list_issues team=ENG limit:5）、函数式字符串、以及 --args 传入 JSON。
• 认证与配置：mcporter config 提供 list|get|add|remove|import|login|logout，把 server 端点与凭据落在本地配置里（默认 ./config/mcporter.json，可用 --config 覆盖）。
• 守护进程：文档中单独列出 Daemon 能力，适合需要常驻连接或复用会话的场景（具体行为以你连接的 MCP server 为准）。
• 代码生成：mcporter generate-cli --server 或 --command 可把 server/命令包装成更易集成的 CLI 形态，减少手写调用样板。

典型流程是：先 config 登记 server 并完成 login（若需要），再用 call 验证工具 schema 与参数，最后在脚本或 CI 里固定同一套调用方式。

适用边界与注意点

• mcporter 解决的是协议层直连与 CLI 编排，不替代 MCP server 自身的业务语义；工具名、参数键必须与目标 server 暴露的接口一致。
• 配置路径与多环境并存时，建议显式指定 --config，避免误用默认目录下的 ./config/mcporter.json。
• 生成 CLI（generate-cli）的输出形态取决于 --server / --command 的选择，生成后仍要对照 server 文档做回归验证。