mcp-cli-exec MCP 服务器

一个强大的 CLI 命令执行 MCP 服务器，支持运行带有结构化输出的 Shell 命令。该软件包专注于命令执行功能，与其他 MCP CLI 工具有所区别。

特征

工具

cli-exec-raw

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

• 接受命令字符串和可选超时（默认值：5 分钟）
• 返回详细的执行结果，包括 stdout、stderr、退出代码
• 使用结构化的错误响应优雅地处理错误

命令行执行

在特定工作目录中执行一个或多个 CLI 命令

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

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

输出格式

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

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

示例用法

cli-exec-raw

简单命令执行：

超时：

命令行执行

特定目录中的单个命令：

多个命令（均在同一个工作目录中运行）：

安装

可选择从 npm 安装：

或者在你的配置中使用 npx

对于 Cline VSCode 扩展

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

对于克劳德桌面

添加到适当的配置文件：

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

特殊 Windows 配置

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

发展

安装依赖项：

构建服务器：

对于使用自动重建的开发：

调试

由于 MCP 服务器通过 stdio 进行通信，调试起来可能颇具挑战性。MCP Inspector 提供了一些实用的调试工具：

这将提供一个 URL 来访问浏览器中的检查器，您可以在其中：

• 查看所有 MCP 消息
• 检查请求/响应有效载荷
• 以交互方式测试工具
• 监视服务器状态

错误处理

该服务器包括全面的错误处理：

• 所有工具参数的输入验证
• 结构化错误响应
• 命令超时处理
• 工作目录验证
• 剥离 ANSI 代码以获得干净的输出

技术细节

• 使用 TypeScript 和 MCP SDK 构建
• 使用 execa 实现可靠的命令执行
• 默认命令超时：5分钟
• 支持 Windows 和类 Unix 系统（使用适合您操作系统的命令，例如“dir”与“ls”）
• 按顺序执行命令，第一次失败时停止
• 每个命令在指定的工作目录中独立运行