1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | mcp-cli-github-awesome-copilot |
| 作者/维护者 | github/awesome-copilot 社区合集(贡献者 Aung Myo Kyaw 于 2026-01 提交) |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/mcp-cli |
| 许可证 | MIT(合集仓库) |
| GitHub Stars / Forks | 合集整体 40,072 / 5,131(GitHub API);该数字属整个合集,不代表本技能自身热度 |
| 第三方安装量 | skills.sh 显示约 9,600 次安装 |
| 技能目录最近提交 | 2026-01-22(合集仓库最近推送 2026-10-16) |
| 它所封装的工具 | philschmid/mcp-cli(MIT,1,279 stars,最近推送 2026-02-05,GitHub API) |
| 安装方式 | 复制 skills/mcp-cli 目录到 agent 的 skills 目录 |
2. 功能介绍与亮点
这是一份只有一个 SKILL.md 的命令速查型技能,教 agent 通过命令行 mcp-cli 去发现和调用 MCP 服务器上的工具,而不必把全部 MCP 工具定义常驻在上下文里。
- 四步工作流:列出服务器和工具、查看某服务器的工具参数、取单个工具的 JSON schema、带 JSON 参数调用。
mcp-cli grep "<glob>"按名称检索工具,-d附带描述。- 支持
--json、--raw输出,方便与jq、管道串联;复杂 JSON 可用 heredoc 或 stdin 传入。 - 给出退出码语义(0 成功、1 客户端错误、2 服务端错误、3 网络错误),便于 agent 判断失败类型。
3. 适用场景
所属分类:集成与工作流自动化。
- 已配置了多个 MCP 服务器、又不想让工具列表占满上下文的开发者,改为需要时再按需查询调用。
- 在脚本或 CI 中通过命令行调用 MCP 工具(读文件、查 GitHub、查文档等)。
- 调试某个 MCP 服务器暴露了哪些工具、参数长什么样。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 技能是标准 SKILL.md,操作全部通过 Bash 执行;前提是本机已装好 mcp-cli 命令 |
| Codex | 需适配 | 技能格式可读,Codex 不自动发现 ~/.codex/skills,需手动引用;同样要先装好 mcp-cli |
| OpenClaw | 未验证 | 未做实机验证;技能本身是纯命令行文本说明 |
| Hermes Agent | 未验证 | 同上 |
5. 推荐理由
MCP 工具多了以后,每个工具的 schema 常驻上下文代价不小。这个技能把“发现、查看、调用”收敛成四条命令,agent 只在需要时才拉取某个工具的详情。它篇幅很短、几乎没有学习成本,适合已经在用 MCP 的中级用户作为省上下文的补充手段。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 合集内安装量约 9,600 次,属同类命令速查技能中的高位;合集 stars 不计入个体 |
| 可用性 | 6 | 命令清晰、示例完整;但 SKILL.md 没有说明如何安装 mcp-cli,也没有说明 mcp_servers.json 的写法,需到上游仓库查阅;技能目录近九个月无更新 |
| 安全性 | 8 | 纯提示词说明,无自带脚本、无自身联网;真实风险来自它调用的 MCP 服务器,由用户自己的配置决定 |
综合 = 三项均值 = 7.0。
安全检查清单:
- 执行 shell 命令:技能指示 agent 运行
mcp-cli命令,范围限于该命令,无额外权限申请。 - 联网外发:技能自身不联网;被调用的 MCP 服务器若是远程 HTTP 类型会产生外联,取决于用户配置。
- 凭据:技能不要求任何 API key。
- 可疑指令:未发现 prompt injection 迹象,无夹带推广内容。
- 作者信誉:托管于 GitHub 官方的 awesome-copilot 合集,经 PR 审核合入。
- License:合集 MIT,明确。
- 维护:合集仍在活跃推送;该技能目录自 2026-01 起无改动。
提示:上游
mcp-cli的官方安装方式是curl ... | bash或bun install -g,使用前建议自行审阅安装脚本。
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 差异 |
|---|---|---|
| 本技能(mcp-cli) | 用命令行按需调用任意 MCP 服务器 | 只是一页命令速查,零代码,依赖上游 mcp-cli 二进制 |
| 在 agent 里直接挂载 MCP 服务器 | 工具定义常驻上下文 | 开箱即用,但工具多时占用大量上下文 |
| mcporter 一类的 MCP 命令行客户端 | 同样把 MCP 变成命令行 | 工具本体功能更多,但各自需要独立的学习和说明文档 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;skills.sh 仅提供安装量数据。
10. 安装使用方式
- 安装上游命令行工具(二选一,以上游 README 为准):
curl -fsSL https://raw.githubusercontent.com/philschmid/mcp-cli/main/install.sh | bash
# 或:bun install -g https://github.com/philschmid/mcp-cli
- 在当前目录或
~/.config/mcp/创建mcp_servers.json,列出要用的 MCP 服务器。 - 把
skills/mcp-cli目录复制到 agent 的 skills 目录(Claude Code 为~/.claude/skills/)。 - 对话中提到“用命令行调用 MCP 工具”即可触发。
11. 注意事项
- 本技能不含
mcp-cli本体,未安装时命令不可用。 - 上游
mcp-cli最近推送在 2026-02,使用前请确认与你的 MCP 服务器版本兼容。 - 被调用的 MCP 工具可能读写文件或访问网络,权限由对应服务器决定,请按最小权限配置。