MCP Cli Exec

🚀 MCP-CLI-EXEC 服務器

MCP-CLI-EXEC 服務器是一個強大的 CLI 命令執行 MCP 服務器，支持在結構化輸出中運行 shell 命令。此包專注於命令執行功能，與其他 MCP CLI 工具不同。

🚀 快速開始

MCP-CLI-EXEC 服務器可讓你方便地執行 CLI 命令並獲取結構化輸出。你可以按照以下步驟快速使用該服務器。

✨ 主要特性

工具

cli-exec-raw

• 執行一條原始 CLI 命令並返回結構化輸出。
• 接受一個命令字符串和可選超時時間（默認：5 分鐘）。
• 返回詳細的執行結果，包括 stdout、stderr 和退出代碼。
• 靈活處理錯誤，提供結構化的錯誤響應。

cli-exec

• 在指定工作目錄中執行一條或多條 CLI 命令。
• 支持單個命令、使用 && 連接的命令鏈或命令數組。
• 所有命令均在指定的工作目錄中執行。
• 返回每個命令的詳細結果，包含成功/失敗狀態、退出代碼、去除 ANSI 碼後的 stdout 和 stderr、執行時長、工作目錄。
• 遇到第一個命令失敗即停止。
• 每個命令可選超時時間（默認：5 分鐘）。

⚠️ 重要提示 由於執行上下文的限制，每個命令獨立運行。命令中的目錄變更（cd）不會影響後續命令。所有命令均在最初指定的工作目錄中執行。

輸出格式

命令返回結構化的結果，涵蓋成功/失敗狀態、退出代碼、去除 ANSI 碼後的 stdout 和 stderr、執行時長、工作目錄以及如有錯誤的詳細錯誤信息。

📦 安裝指南

從 npm 安裝

你可以選擇從 npm 全局安裝該工具：

npm install -g mcp-cli-exec
# 或使用 pnpm
pnpm add -g mcp-cli-exec

使用 npx

也可以直接在配置中使用 npx。

針對不同工具的配置

Cline VSCode 擴展

添加到 %APPDATA%/Code - Insiders/User/globalStorage/rooveterinaryinc.roo-cline/exec：

{
  "command": "echo Hello World"
}

Claude Desktop

添加到 Claude Desktop 設置中：

{
  "workingDirectory": "C:\\project",
  "commands": [
    "dir /b",
    "npm run build"
  ]
}

💻 使用示例

基礎用法

cli-exec-raw

簡單命令執行：

{
  "command": "echo Hello World"
}

帶超時設置：

{
  "command": "long-running-script.sh",
  "timeout": 300000
}

cli-exec

在特定目錄中執行單個命令：

{
  "workingDirectory": "/path/to/project",
  "commands": "npm install"
}

高級用法

在同一工作目錄中執行多個命令：

{
  "workingDirectory": "C:\\project",
  "commands": [
    "dir /b",
    "npm run build"
  ]
}

🔧 技術細節

• 默認超時時間：5 分鐘。
• 使用 execa 執行外部命令。
• 每個命令獨立運行，互不影響。