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

# 或從檔案/指令 pipe
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：網路錯誤