SKILL.md
唯讀
名稱
mcp-cli
描述
透過命令列介面操作 MCP(模型上下文協定)伺服器。當你需要透過 MCP 伺服器與外部工具、API 或資料來源互動、列出可用的 MCP 伺服器/工具,或從命令列呼叫 MCP 工具時使用。
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)
工作流程
- 探索:
mcp-cli→ 查看可用的伺服器與工具 - 檢視:
mcp-cli <server>→ 查看工具及其參數 - 檢查:
mcp-cli <server>/<tool>→ 取得完整的 JSON 輸入結構 - 執行:
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:網路錯誤






