mcp-cli

MCP-CLI

通过命令行访问MCP服务器。MCP支持与GitHub、文件系统、数据库和API等外部系统交互。

命令

命令	输出
mcp-cli	列出所有服务器和工具名称
mcp-cli <server>	显示工具及其参数
mcp-cli <server>/<tool>	获取工具JSON模式
mcp-cli <server>/<tool> '<json>'	使用参数调用工具
mcp-cli grep "<glob>"	按名称搜索工具

添加 -d 以包含描述（例如：mcp-cli filesystem -d）

工作流程

1. 发现：mcp-cli → 查看可用的服务器和工具
2. 探索：mcp-cli <server> → 查看工具及其参数
3. 检查：mcp-cli <server>/<tool> → 获取完整的JSON输入模式
4. 执行：mcp-cli <server>/<tool> '<json>' → 使用参数运行

示例

# 列出所有服务器和工具名称
mcp-cli

# 查看所有工具及其参数
mcp-cli filesystem

# 包含描述（更详细）
mcp-cli filesystem -d

# 获取特定工具的JSON模式
mcp-cli filesystem/read_file

# 调用工具
mcp-cli filesystem/read_file '{"path": "./README.md"}'

# 搜索工具
mcp-cli grep "*file*"

# JSON输出以便解析
mcp-cli filesystem/read_file '{"path": "./README.md"}' --json

# 带引号的复杂JSON（使用heredoc或stdin）
mcp-cli server/tool <<EOF
{"content": "Text with 'quotes' inside"}
EOF

# 或从文件/命令管道输入
cat args.json | mcp-cli server/tool

# 查找所有TypeScript文件并读取第一个
mcp-cli filesystem/search_files '{"path": "src/", "pattern": "*.ts"}' --json | jq -r '.content[0].text' | head -1 | xargs -I {} sh -c 'mcp-cli filesystem/read_file "{\"path\": \"{}\"}"'

选项

标志	用途
-j, --json	JSON输出，用于脚本
-r, --raw	原始文本内容
-d	包含描述

退出码

• 0：成功
• 1：客户端错误（参数错误，缺少配置）
• 2：服务器错误（工具失败）
• 3：网络错误