适合谁
- 希望以微创方式集成 MCP 服务器的 AI 编码代理。
- 需要在终端中直接操作 MCP 工具的开发者。
- 需要高效、可脚本化访问 MCP 工具的用户。
M
64FMRS · C
mcp-cli 是一个功能丰富的 CLI 工具，特别适合 AI 代理和终端用户，它以脚本友好方式提供对 MCP 服务器的访问。
mcp-cli 是一个基于 Bun 的轻量级 CLI，用于与 Model Context Protocol (MCP) 服务器交互。它支持通过 stdio 和 HTTP 传输的服务器，提供工具发现、模式查看、调用等功能，并优化了 AI 编程代理的使用体验。
工具能力
info
显示服务器信息、可用工具和模式。
grep
按 glob 模式搜索工具。
call
调用服务器上的工具，支持内联 JSON 或从 stdin 读取。
安装接入
- 安装：
curl -fsSL https://raw.githubusercontent.com/philschmid/mcp-cli/main/install.sh | bash或bun install -g https://github.com/philschmid/mcp-cli。2. 创建配置文件mcp_servers.json（见上图）。3. 使用mcp-cli命令。
claude_desktop_config.json
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"."
]
},
"deepwiki": {
"url": "https://mcp.deepwiki.com/mcp"
}
}
}
选型与风险
不适合谁
- 需要图形界面的用户。
- 不使用 MCP 协议的场景。
- 需要持久连接或重型会话管理的场景（CLI 设计为一次性请求）。
所需权限
- 读取和写入配置文件中指定的 MCP 服务器配置。
- 通过 stdio 启动子进程（如 npx）。
- 建立网络连接以访问远程 MCP 服务器（如果配置）。
- 创建临时 Unix 套接字用于连接池（默认启用守护进程模式）。
风险与副作用
- 配置中的敏感信息（如 API 密钥）可能以明文存储。
- 启动的 MCP 服务器可能执行任意命令，尤其是从不可信来源安装时。
- 连接保持活动可能导致资源占用，如果长时间不活动。
- 使用 npm/npx 包作为服务器命令时，存在供应链风险。
常见排障
- 检查配置文件路径是否正确（`mcp_servers.json` 或 `~/.config/mcp/`）。
- 设置 `MCP_DEBUG=1` 查看调试输出。
- 设置 `MCP_NO_DAEMON=1` 禁用连接缓存，解决连接问题。
- 确保服务器命令可用（如 `npx` 已安装）。
- 验证环境变量替换（`${VAR}`）是否满足 `MCP_STRICT_ENV` 要求。
- 参考错误消息中的恢复建议。
使用场景
在命令行中快速列出和调用 MCP 工具。
为 AI 编码代理（如 Gemini CLI、Claude Code）提供 MCP 服务器的命令行接口。
在 shell 脚本中通过管道与 jq 等工具组合使用 MCP 工具。
支持客户端
Claude Desktop部分支持
Gemini CLI部分支持
OpenCode部分支持
Claude Code部分支持