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