mcp-cli-exec MCP Server

基本能力

产品定位

mcp-cli-exec 是一个专注于 CLI 命令执行的 MCP 服务器，提供结构化的命令执行结果输出。

核心功能

1. cli-exec-raw：执行原始 CLI 命令并返回结构化输出
2. 支持命令字符串和可选超时设置（默认5分钟）
3. 返回详细执行结果（标准输出、标准错误、退出码）

4. 提供结构化的错误响应

5. cli-exec：在特定工作目录中执行一个或多个 CLI 命令

6. 支持单个命令、&&链式命令或命令数组
7. 所有命令在指定工作目录中执行
8. 返回每个命令的详细结果（状态、退出码、输出、执行时长等）
9. 遇到第一个失败命令时停止
10. 支持每个命令的超时设置（默认5分钟）

适用场景

1. 需要在程序中执行 CLI 命令并获取结构化结果的场景
2. 需要在特定工作目录中执行多个命令的场景
3. 需要监控命令执行时长和状态的自动化任务

工具列表

1. cli-exec-raw：执行原始 CLI 命令
2. cli-exec：在指定目录中执行一个或多个命令

常见问题解答

1. 命令执行上下文限制：每个命令独立运行，目录变更不影响后续命令
2. Windows 特殊配置：遇到 ENOENT spawn npx 问题时需要使用完整路径配置

使用教程

使用依赖

需要安装 Node.js 环境

安装教程

1. 通过 npm 全局安装：

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

1. 对于 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"]
    }
  }
}

1. 对于 Claude Desktop，添加配置到： Windows: %APPDATA%/Claude/claude_desktop_config.json MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

调试方式

1. 使用 MCP Inspector 进行调试：

pnpm run inspector

1. 访问提供的 URL 可以：
2. 查看所有 MCP 消息
3. 检查请求/响应负载
4. 交互式测试工具
5. 监控服务器状态

许可证

None