安装方式
手动下载安装
下载 ZIP 后解压到技能目录即可安装。若在桌面客户端 WebView中直接下载出现异常，本站会改为提示页 + 原始链接，请按页内说明操作。
下载 ZIP (oss-superpowers-lab-mcp-cli-v1.0.0.zip)触发指令
/mcp-cli
跨平台安装指引
该技能声明兼容以下 1 个平台，将 ZIP 解压到对应目录即可被识别。
unzip oss-superpowers-lab-mcp-cli-v1.0.0.zip -d ~/.claude/skills/
mkdir -p 创建；启用 Skill 后请重启对应 Agent 让配置生效。
使用指南
MCP CLI：按需使用 MCP 服务
用 mcp 命令行 动态发现并调用 MCP 服务器能力，无需 事先把每个服务都配成常驻集成，也 减少 把大段 MCP 文档预载进上下文。
何时使用
- 探索某 MCP 服务是否值得长期接入
- 一次性 调用，不想改全局配置
- 不想用预加载 MCP 撑爆上下文
- 调试、验证 MCP 服务
- 服务尚未在客户端里预配置
前置：mcp 可执行文件
期望路径 ~/.local/bin/mcp。若无：
cd /tmp && git clone --depth 1 https://github.com/f/mcptools.git
cd mcptools && CGO_ENABLED=0 go build -o ~/.local/bin/mcp ./cmd/mcptools
export PATH="$HOME/.local/bin:$PATH"
发现流程
- 工具列表：
mcp tools <启动服务器的命令…> - 资源列表：
mcp resources <server-command> - 提示词列表：
mcp prompts <server-command> - JSON 详情：
mcp tools --format json或--format pretty
示例启动方式：本地 npx -y @modelcontextprotocol/server-filesystem /path、带 token 的 docker run … github-mcp-server、远程 https://host/mcp 等。
调用工具
mcp call <tool_name> --params '<json>' <server-command>
嵌套 JSON 用单引号包住；复杂参数可写文件再 --params "$(cat params.json)"。
输出格式： 默认表格；-f json / -f pretty 便于解析。
读资源 / 用提示词
mcp read-resource <resource-uri> <server-command>
mcp get-prompt <prompt-name> <server-command>
mcp get-prompt <name> --params '{"arg":"v"}' <server-command>
别名（同一会话反复用）
mcp alias add fs npx -y @modelcontextprotocol/server-filesystem /home/user
mcp call read_file --params '{"path":"README.md"}' fs
mcp alias list
mcp alias remove fs
配置存 ~/.mcpt/aliases.json。
认证
- HTTP Basic：
--auth-user user:pass - Bearer：
--auth-header "Bearer …" - Docker：
-e VAR=value传入 token
传输
stdio（默认，本地 npx 等）、HTTP/HTTPS（自动）、SSE（--transport sse 或 URL 暗示）。
常用服务器（示例命令）
文件系统、memory、GitHub（需 token）、Brave Search、Puppeteer 等——与官方包名一致，用 mcp tools <启动命令> 先看工具表。
最佳实践
先 mcp tools 看清 schema；要解析结果用 -f json；参数类型与表格签名一致（str/num/bool/数组等）；失败看退出码与 stderr；同会话多次调用用 alias；可用 mcp guard --allow … --deny … 限制危险工具。
调试
mcp tools --server-logs …；查 ~/.mcpt/aliases.json；--format pretty 看参数问题。
速查
| 动作 | 命令 |
|------|------|
| 列工具 | mcp tools <server> |
| 列资源 | mcp resources <server> |
| 列提示 | mcp prompts <server> |
| 调工具 | mcp call … --params '…' <server> |
| 读资源 | mcp read-resource <uri> <server> |
| 取提示 | mcp get-prompt … |
| 别名 | mcp alias add|remove|list |
故障
command not found → 检查 PATH。JSON 错 → 单引号、转义、或临时文件。超时 → CLI 会等服务就绪。权限 → 检查 filesystem 允许路径。
<!-- zh-only -->
# MCP CLI：按需使用 MCP 服务
用 **`mcp` 命令行** 动态发现并调用 MCP 服务器能力，**无需** 事先把每个服务都配成常驻集成，也 **减少** 把大段 MCP 文档预载进上下文。
## 何时使用
- 探索某 MCP 服务是否值得长期接入
- **一次性** 调用，不想改全局配置
- 不想用预加载 MCP **撑爆上下文**
- 调试、验证 MCP 服务
- 服务尚未在客户端里预配置
## 前置：`mcp` 可执行文件
期望路径 `~/.local/bin/mcp`。若无：
```bash
cd /tmp && git clone --depth 1 https://github.com/f/mcptools.git
cd mcptools && CGO_ENABLED=0 go build -o ~/.local/bin/mcp ./cmd/mcptools
export PATH="$HOME/.local/bin:$PATH"
```
## 发现流程
1. **工具列表：** `mcp tools <启动服务器的命令…>`
2. **资源列表：** `mcp resources <server-command>`
3. **提示词列表：** `mcp prompts <server-command>`
4. **JSON 详情：** `mcp tools --format json` 或 `--format pretty`
示例启动方式：本地 `npx -y @modelcontextprotocol/server-filesystem /path`、带 token 的 `docker run … github-mcp-server`、远程 `https://host/mcp` 等。
## 调用工具
```bash
mcp call <tool_name> --params '<json>' <server-command>
```
嵌套 JSON 用单引号包住；复杂参数可写文件再 `--params "$(cat params.json)"`。
**输出格式：** 默认表格；`-f json` / `-f pretty` 便于解析。
## 读资源 / 用提示词
```bash
mcp read-resource <resource-uri> <server-command>
mcp get-prompt <prompt-name> <server-command>
mcp get-prompt <name> --params '{"arg":"v"}' <server-command>
```
## 别名（同一会话反复用）
```bash
mcp alias add fs npx -y @modelcontextprotocol/server-filesystem /home/user
mcp call read_file --params '{"path":"README.md"}' fs
mcp alias list
mcp alias remove fs
```
配置存 `~/.mcpt/aliases.json`。
## 认证
- HTTP Basic：`--auth-user user:pass`
- Bearer：`--auth-header "Bearer …"`
- Docker：`-e VAR=value` 传入 token
## 传输
stdio（默认，本地 npx 等）、HTTP/HTTPS（自动）、SSE（`--transport sse` 或 URL 暗示）。
## 常用服务器（示例命令）
文件系统、memory、GitHub（需 token）、Brave Search、Puppeteer 等——与官方包名一致，用 `mcp tools <启动命令>` 先看工具表。
## 最佳实践
先 `mcp tools` 看清 schema；要解析结果用 `-f json`；参数类型与表格签名一致（`str`/`num`/`bool`/数组等）；失败看退出码与 stderr；同会话多次调用用 alias；可用 `mcp guard --allow … --deny …` 限制危险工具。
## 调试
`mcp tools --server-logs …`；查 `~/.mcpt/aliases.json`；`--format pretty` 看参数问题。
## 速查
| 动作 | 命令 |
|------|------|
| 列工具 | `mcp tools <server>` |
| 列资源 | `mcp resources <server>` |
| 列提示 | `mcp prompts <server>` |
| 调工具 | `mcp call … --params '…' <server>` |
| 读资源 | `mcp read-resource <uri> <server>` |
| 取提示 | `mcp get-prompt …` |
| 别名 | `mcp alias add|remove|list` |
## 故障
`command not found` → 检查 PATH。JSON 错 → 单引号、转义、或临时文件。超时 → CLI 会等服务就绪。权限 → 检查 filesystem 允许路径。