SuperAPI AI 工具集

mcpc

编程与开发

查看项目

更新于 10-30 17:17

技能介绍

mcpc 是 MCP 命令行的客户端。它的用途是:在命令行与 MCP(Model Context Protocol)服务器交互,用生成 shell 命令的方式代替函数调用,便于通过管道组合,并适用于不同类型的智能体。

主要能力:

  • 连接服务器:可从 mcpc 配置文件按 file:entry 语法连接(mcpc connect <config>:<entry> @<name>),也可直接连接远程 URL;支持 bearer 头与 OAuth 配置。
  • 工具操作:列出工具(tools-list、--full)、查看工具定义(tools-get)、调用工具(tools-call),参数使用 key:=value 语法,值会自动按 JSON 解析,也可传内联 JSON 或从 stdin 读取。
  • 资源与提示词:resources-list、resources-read、prompts-list、prompts-get。
  • 异步任务:--task、--detach 发起,tasks-list 与 tasks-result 查询结果。
  • 会话管理:会话是持久的命名连接,状态包括 live、connecting、disconnected、crashed、unauthorized、expired;可 ping、restart、close。
  • 搜索:mcpc grep <pattern> 跨会话搜索工具,或在指定会话内搜索。
  • JSON 输出:--json 输出符合 MCP 规范的机器可读结果,便于用 jq 提取或跨会话串联。
  • 模式校验:用 tools-get 保存工具模式快照,调用前通过 --schema 校验,以发现破坏性变更。
  • 代理:--proxy 暴露会话而不泄露凭据,供沙箱访问。
  • 调试:--verbose 输出协议细节到 stderr,tail_log 或读取 ~/.mcpc/logs/bridge-@<session>.log 查看桥接日志。退出码:0 成功、1 客户端错误、2 服务器错误、3 网络错误、4 认证错误。

使用方式:先连接会话(如 mcpc connect ~/.mcpc/mcp.json:playwright @pw),之后用 mcpc @pw tools-list、tools-call 等操作;脚本中需注意 mcpc 二进制位于 ~/.bun/bin,非登录 PATH 下应先 export PATH="$HOME/.bun/bin:$PATH",否则退出 127。参数 := 两侧不能有空格,含空格的值需加引号。

资料中列出的已配置服务器与注意事项:context7、pixellab、MiniMax、gemini-cli、playwright、searxng,以及 Z.ai coding-plan 服务器(key 为 ZAI_AUTH_TOKEN):@zai-search(web_search_prime)、@zai-reader(webReader)、@zread(search_doc、read_file、get_repo_structure,repo_name 用 owner/repo)、@zai-vision(analyze_image、ui_to_artifact、OCR 等,stdio npx @z_ai/mcp-server,仅本地文件路径,远程 URL 会报 400 图片输入格式/解析错误,需 Node ≥22)、@minimax(web_search、understand_image,uvx minimax-coding-plan-mcp,key 为 MINIMAX_CODING_KEY)。官方生成式 MiniMax-MCP(uvx minimax-mcp:TTS/视频/图像/音乐)属于按次计费平台 API,不在 coding plan 覆盖范围,仅在用户明确要求时添加。

适用场景:在终端或智能体脚本中批量调用 MCP 工具、跨会话组合工具输出、保存与校验工具模式、为沙箱提供代理访问、调试 MCP 连接。

限制:需自行提供 mcpc 配置及服务器凭据;视觉工具不接受远程图片 URL;PATH 与参数语法有特定要求;资料未提供安装命令、收费与价格信息,暂未提供。