system-command-mcp
跨平台系统命令 MCP Server。AI 使用稳定的 program + args[] 接口调用已注册程序，不需要选择 Bash、PowerShell 或 cmd.exe，也不需要用 which、where、command -v、Get-Command 探测工具。
工具
system_exec
program 枚举在 Server 启动时根据当前 PATH 自动生成：
{
"program": "git",
"args": ["status", "--short"],
"cwd": ".",
"timeoutMs": 30000
}
参数不会经过 Shell 展开，$HOME、*.ts、&& 等会原样传递。
system_environment
返回平台、架构、根工作目录，以及逻辑程序名到真实可执行文件的映射。通常无需先调用；system_exec.program 的 Schema 已包含可用程序。
构建和测试
npm install
npm run build
npm test
需要 Node.js 20 或更高版本。
MCP 配置
{
"mcpServers": {
"system-command": {
"command": "node",
"args": [
"/absolute/path/system-command-mcp/dist/src/cli.js",
"--root",
"/absolute/path/to/workspace"
]
}
}
}
默认逻辑程序名
- git、node、npm、pnpm、yarn、bun
- python：依次解析 python3、python
- ripgrep：解析 rg
- powershell：依次解析 pwsh、powershell
只暴露当前环境实际存在的程序。
当前限制
- 仅支持 stdio transport；
- 不支持管道、重定向、任意 Shell 脚本、交互式 TTY 或后台常驻进程；
- 默认超时 30 秒，stdout/stderr 分别保留最后 1 MiB；
- cwd 必须位于 --root 内；
- 程序快照在启动时生成，环境变化后需重启 Server；
- 超时和取消只保证终止直接子进程，不保证清理完整进程树。
