mcp-cli-exec mcp服务器
一个功能强大的CLI命令执行MCP服务器，支持运行具有结构化输出的shell命令。此软件包专门关注命令执行功能，将其与其他MCP CLI工具区分开来。
特性
工具
cli执行原始
执行原始CLI命令并返回结构化输出
- 接受命令字符串和可选超时（默认值：5分钟）
- 返回详细的执行结果，包括stdout、stderr、退出代码
- 通过结构化错误响应优雅地处理错误
cli执行
在特定工作目录中执行一个或多个CLI命令
- 支持单个命令、&&链式命令或命令数组
- 所有命令都在指定的工作目录中执行
- 返回每个命令的详细结果：
- 成功/失败状态 - 退出代码 - stdout和stderr（去除ANSI代码） - 执行持续时间 - 工作目录
- 第一次命令失败时停止
- 每个命令的可选超时（默认值：5分钟）
注意：由于执行上下文的限制，每个命令都独立运行。命令中的目录更改（cd）不会影响后续命令。所有命令都在最初指定的工作目录中执行。
输出格式
命令返回结构化结果，包括：
- 成功/失败状态
- 退出代码
- stdout和stderr（去掉ANSI代码）
- 执行持续时间
- 工作目录
- 详细的错误信息（如适用）
示例用法
cli执行原始
简单命令执行：
{
"command": "echo Hello World"
}超时：
{
"command": "long-running-script.sh",
"timeout": 300000
}cli执行
特定目录中的单个命令：
{
"workingDirectory": "/path/to/project",
"commands": "npm install"
}多个命令（均在同一工作目录中运行）：
{
"workingDirectory": "C:\\project",
"commands": [
"dir /b",
"npm run build"
]
}安装
可选从npm安装：
npm install -g mcp-cli-exec
# or with pnpm
pnpm add -g mcp-cli-exec或者在配置中使用npx
用于临床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"]
}
}
}适用于克劳德桌面
添加到相应的配置文件中：
窗户： %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"
]
}
}
}发展
安装依赖项：
pnpm install构建服务器：
pnpm run build对于自动重建的开发：
pnpm run watch调试
由于MCP服务器通过stdio进行通信，调试可能具有挑战性。MCP检查器提供有用的调试工具：
pnpm run inspector这将提供一个URL，用于在浏览器中访问检查器，您可以在其中：
- 查看所有MCP消息
- 检查请求/响应有效载荷
- 交互式测试工具
- 监控服务器状态
错误处理
服务器包括全面的错误处理：
- 所有工具参数的输入验证
- 结构化错误响应
- 命令超时处理
- 工作目录验证
- ANSI代码剥离，输出干净
技术细节
- 使用TypeScript和MCP SDK构建
- 使用execa实现可靠的命令执行
- 默认命令超时：5分钟
- 支持Windows和类Unix系统（使用适合您操作系统的命令，例如“dir”vs“ls”）
- 按顺序执行命令，在第一次失败时停止
- 每个命令在指定的工作目录中独立运行