shell-mcp

提供安全Shell命令执行功能的MCP服务器

一个提供LLMs安全Shell命令执行能力的MCP服务器实现。

特性

• 安全执行：仅允许白名单中的命令和参数
• 资源控制：监控内存和CPU使用情况
• 超时控制：自动终止长时间运行的命令
• 大小限制：为了安全起见，对输出大小进行限制
• MCP集成：与Claude和其他兼容MCP的LLMs协同工作

安装

npm install @kevinwatt/shell-mcp

使用Dive Desktop配置

1. 在Dive Desktop中点击“+ 添加MCP服务器”
2. 复制并粘贴以下配置：

{
  "mcpServers": {
    "shell": {
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/shell-mcp"
      ]
    }
  }
}

工具文档

• shell_ls, shell_pwd, shell_df等
  • 执行白名单中的Shell命令
  • 输入：
    • command（字符串，必需）：要执行的命令
    • args（数组，可选）：命令参数
    • timeout（数字，可选）：执行超时时间（毫秒）

使用示例

让您的LLM执行：

"使用shell_pwd显示当前目录"
"使用shell_ls和-l参数列出文件"
"使用shell_df和-h参数检查磁盘使用情况"

手动启动

如需手动启动服务器，请执行：

npx @kevinwatt/shell-mcp

要求

• Node.js 18+
• 兼容MCP的LLM服务

开发

# 安装依赖
npm install

# 监控模式
npm run watch

# 运行测试
npm test

# 检查代码
npm run lint

许可证

MIT © Dewei Yen

关键词

• mcp
• shell
• 命令
• claude
• llm
• 自动化

可用命令

以下Shell命令可用：

命令	描述	允许的参数
ls	列出目录内容	-l, -a, -h, -R, --help, *
cat	合并并显示文件内容	-n, -b, --help, *
pwd	显示当前工作目录	无
df	显示磁盘使用情况	-h, -T, --help
echo	显示文本	任何文本
ps	显示进程状态	-e, -f, -u, --help
free	显示内存使用情况	-h, -m, -g, --help
uptime	显示系统运行时间	无
date	显示系统日期和时间	+%Y-%m-%d, +%H:%M:%S, --help
grep	在文件中搜索文本模式	-i, -v, -n, -r, -l, --color, *
w	显示登录用户及其正在做的事情	-h, -s, --no-header, --help
whois	查询WHOIS域名注册信息	-H, *
find	在目录层次结构中搜索文件	-name, -type, -size, -mtime, *
netstat	网络连接信息	-a, -n, -t, -u, -l, -p, --help
lspci	列出PCI设备	-v, -k, -mm, -nn, --help
lsusb	列出USB设备	-v, -t, -d, -s, --help
dig	DNS查询工具	+short, +trace, +dnssec, @*, *
nslookup	查询DNS记录	-type=, -query=, *
ip	显示网络设备和接口	addr, link, route, neigh, -br, *
whereis	查找二进制、源码和手册文件	-b, -m, -s, *