MCP 服务器

Shell-MCP

一个安全的 MCP 服务器，用于执行白名单中的 shell 命令，并具有资源和超时控制，专为与 Claude 和其他 MCP 兼容的 LLM 集成而设计。

Tools

shell_ps

Show process status

shell_free

Show memory usage

shell_uptime

Show system uptime

shell_date

Show system date and time

shell_grep

Search text patterns in files

shell_netstat

Network connection information

shell_lspci

List PCI devices

shell_lsusb

List USB devices

shell_dig

DNS lookup utility

shell_nslookup

Query DNS records

shell_ip

Show / manipulate routing, network devices, interfaces and tunnels

shell_whereis

Locate the binary, source, and manual page files for a command

shell_df

Show disk usage

shell_echo

Display text

shell_ls

List directory contents

shell_cat

Concatenate and display file contents

shell_pwd

Show current working directory

shell_w

Show who is logged on and what they are doing

shell_whois

Query WHOIS domain registration information

shell_find

Search for files in a directory hierarchy

README

shell-mcp

Shell 命令执行 MCP 服务器

一个 MCP 服务器实现，为 LLM 提供安全的 shell 命令执行能力。

特性

安全执行: 仅允许白名单中的命令和参数
资源控制: 内存和 CPU 使用率监控
超时控制: 自动终止长时间运行的命令
大小限制: 输出大小限制，保证安全
MCP 集成: 与 Claude 和其他 MCP 兼容的 LLM 协同工作

安装

npm install @kevinwatt/shell-mcp

使用 Dive Desktop 进行配置

在 Dive Desktop 中点击 "+ Add MCP Server"
复制并粘贴以下配置：

{
  "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
command
claude
llm
automation

可用命令

以下 shell 命令可用：

命令	描述	允许的参数
ls	列出目录内容	-l, -a, -h, -R, --help, *
cat	连接并显示文件内容	-n, -b, --help, *
pwd	显示当前工作目录	None
df	显示磁盘使用情况	-h, -T, --help
echo	显示文本	任何文本
ps	显示进程状态	-e, -f, -u, --help
free	显示内存使用情况	-h, -m, -g, --help
uptime	显示系统运行时间	None
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, *