mcp-cli

mcp-cli

熱門

透過命令列介面操作 MCP(模型上下文協定)伺服器。當你需要透過 MCP 伺服器與外部工具、API 或資料來源互動、列出可用的 MCP 伺服器/工具,或從命令列呼叫 MCP 工具時使用。

3.6萬星標
0分支
更新於 2026/7/11
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

工作流程

  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:網路錯誤