Shell命令执行MCP服务器

用于大语言模型（LLM）的安全Shell命令执行MCP服务器

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

特性

• 安全执行：仅允许白名单中的命令和参数
• 资源控制：内存和CPU使用情况监控
• 超时控制：自动终止长时间运行的命令
• 大小限制：输出结果大小限制以确保安全
• MCP集成：与Claude和其他兼容MCP的LLM一起使用

安装

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 © 德维·严

关键字

• mcp
• shell
• command
• claude
• llm
• 自动化

可用命令

以下Shell命令可供使用：

注意：所有命令都需要通过白名单验证后方可执行。