MCP 服务器

mcp-cli-exec MCP Server

一个 CLI 命令执行服务器，它能够运行 shell 命令并提供结构化的输出，包括 stdout、stderr、退出码和执行时长等详细的执行结果。

Tools

cli-exec-raw

Execute a raw CLI command and return structured output

cli-exec

Execute one or more CLI commands in a specific working directory

README

mcp-cli-exec MCP 服务器

一个强大的 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/settings/cline_mcp_settings.json：

{
  "mcpServers": {
    "mcp-cli-exec": {
      "command": "npx",
      "args": ["-y", "mcp-cli-exec"]
    }
  }
}

对于 Claude Desktop

添加到相应的配置文件：

Windows: %APPDATA%/Claude/claude_desktop_config.json MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-cli-exec": {
      "command": "npx",
      "args": ["-y", "mcp-cli-exec"]
    }
  }
}

特殊的 Windows 配置

如果在 Windows 上遇到 ENOENT spawn npx 问题，请使用以下指定完整路径的替代配置：

{
  "mcpServers": {
    "mcp-cli-exec": {
      "command": "C:\\Users\\jim\\AppData\\Roaming\\nvm\\v22.1.0\\node.exe",
      "args": [
        "C:\\Users\\jim\\AppData\\Roaming\\npm\\node_modules\\npm\\bin\\npx-cli.js",
        "-y",
        "mcp-cli-exec"
      ]
    }
  }
}