安全的unix mcp
暴露的stdio MCP服务器 只读的 类Unix工具到AI代理（Crush）。
- 传输：标准传输（MCP）。
- 主机：任何MCP客户端（例如Crush）。
- 操作系统：Linux/macOS（BSD/GNU差异保守处理）。
为什么
- 可移植操作系统接口
find包含-exec/-ok其执行命令；我们 禁止 他们。 - GNU/BSD
find -delete具有破坏性；也 禁止. - 许多coreutils具有危险标志（例如。，
sed -i)；我们 块 他们。
参考文献
- MCP运输和规格。
- POSIX外壳和实用程序（开放组）。
- GNU核心工具手册。
安装
克隆存储库
git clone https://github.com/YOUR_USERNAME/safe-unix-mcp.git
cd safe-unix-mcp全局安装
npm install -g .这使 mcp-safe-unix 命令在系统范围内可用。
粉碎快速设置
全局安装后，运行安装实用程序自动配置您的Crush配置：
setup-safe-unix此交互式脚本将：
- 创建
~/.crush.json如果它不存在 - 添加安全的unix MCP服务器配置
- 检测并选择性地删除可能不安全的Unix/shell服务器
- 更新现有的安全unix配置（如果已存在）
选项：
setup-safe-unix --config-path=/custom/path/to/config.json # Use custom config path
setup-safe-unix --force # Skip confirmation prompts手动设置
如果您更喜欢手动配置，请将以下内容添加到您的 ~/.crush.json:
{
"mcpServers": {
"safe-unix": {
"command": "mcp-safe-unix",
"transport": "stdio"
}
}
}验证安装
echo '{"jsonrpc":"2.0","id":1,"method":"initialize"}' | mcp-safe-unix使用Crush
自动设置（推荐）
安装后使用安装实用程序：
setup-safe-unix手动配置
添加到您的 ~/.crush.json 配置文件：
{
"mcpServers": {
"safe-unix": {
"command": "mcp-safe-unix",
"transport": "stdio"
}
}
}如果您不希望全局安装，可以指定脚本的完整路径：
{
"mcpServers": {
"safe-unix": {
"command": "node",
"args": ["/path/to/safe-unix-mcp/mcp-safe-unix.js"],
"transport": "stdio"
}
}
}或使用 npx:
{
"mcpServers": {
"safe-unix": {
"command": "npx",
"args": ["-y", "/path/to/safe-unix-mcp"],
"transport": "stdio"
}
}
}可用工具
服务器公开了以下安全的只读Unix工具：
- 目录和文件列表:
safe_ls,safe_pwd,safe_stat,safe_file - 查看/分页:
safe_cat,safe_head,safe_tail,safe_less,safe_more - 搜索和筛选:
safe_grep,safe_awk,safe_sed - 文本转换:
safe_cut,safe_paste,safe_tr,safe_sort,safe_uniq,safe_fmt,safe_fold,safe_column - 计数/校验和:
safe_wc,safe_cksum,safe_sha - 档案检查:
safe_tar_list,safe_zipinfo,safe_unzip_list - FS使用情况:
safe_du,safe_df - 流程和环境:
safe_env,safe_id,safe_uname,safe_date,safe_ps,safe_uptime - 安全查找:
safe_find（无-exec,-ok,-delete) - Git（只读）:
safe_git（状态、差异、显示、日志等） - JSON/YAML:
safe_jq,safe_yq - 十六进制/编码:
safe_hexdump,safe_xxd,safe_od - 树:
safe_tree - macOS:
safe_sw_vers
发展
本地测试，无需全局安装
# Test with node directly
echo '{"jsonrpc":"2.0","id":1,"method":"initialize"}' | node mcp-safe-unix.js
# Or use npm link for development
npm link卸载
npm uninstall -g safe-unix-mcp