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"

发现流程

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 等。

调用工具

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 允许路径。