MCP-CLI-EXEC 服务器

一个强大的 CLI 命令执行 MCP 服务器，支持在结构化输出中运行 shell 命令。此包专注于命令执行功能，与其他 MCP CLI 工具不同。

功能

工具

cli-exec-raw

执行一条原始 CLI 命令并返回结构化输出

• 接受一个命令字符串和可选超时时间（默认：5 分钟）
• 返回详细的执行结果，包括 stdout、stderr 和退出代码
• 灵活处理错误，提供结构化的错误响应

cli-exec

在指定工作目录中执行一条或多条 CLI 命令

• 支持单个命令、使用 && 连接的命令链或命令数组
• 所有命令均在指定的工作目录中执行
• 返回每个命令的详细结果：
  • 成功/失败状态
  • 退出代码
  • stdout 和 stderr（去除 ANSI 码）
  • 执行时长
  • 工作目录
• 遇到第一个命令失败即停止
• 每个命令可选超时时间（默认：5 分钟）

注意：由于执行上下文的限制，每个命令独立运行。命令中的目录变更（cd）不会影响后续命令。所有命令均在最初指定的工作目录中执行。

输出格式

命令返回结构化的结果，包括：

• 成功/失败状态
• 退出代码
• stdout 和 stderr（去除 ANSI 码）
• 执行时长
• 工作目录
• 如有错误的详细错误信息

示例用法

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"
  ]
}

安装

可选从 npm 安装：

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

或直接在配置中使用 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"
  ]
}

开发

项目使用 TypeScript 和 MCP SDK 构建。要运行测试，请执行：

npm test

调试

要在 VSCode 中进行调试，配置 launch.json 如下：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "调试服务器",
      "type": "node",
      "request": "launch",
      "program": "dist/index.js",
      "args": []
    }
  ]
}

技术细节

• 默认超时时间：5 分钟
• 使用 execa 执行外部命令
• 每个命令独立运行，互不影响