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 执行外部命令。
• 每个命令独立运行，互不影响。