Shell MCP

🚀 Shell命令執行MCP服務器

本項目是一個用於大語言模型（LLM）的安全Shell命令執行MCP服務器，為LLM提供了安全可靠的Shell命令執行能力，保障執行過程的安全性與可控性。

🚀 快速開始

本項目是一個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 (數字，可選)：執行超時時間（單位：毫秒）。

手動啟動

如果需要，您可以手動啟動服務器：

npx @kevinwatt/shell-mcp

需求

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

開發

# 安裝依賴項
npm install

# 監視模式
npm run watch

# 運行測試
npm test

# 校驗代碼風格
npm run lint

💻 使用示例

基礎用法

要求您的LLM執行以下操作：

"顯示當前目錄使用shell_pwd"
"使用shell_ls和-l參數列出文件"
"使用shell_df和-h參數檢查磁盤使用情況"

📄 許可證

本項目採用MIT許可證 © 德維·嚴

🔍 關鍵字

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

📋 可用命令

⚠️ 重要提示

所有命令都需要通過白名單驗證後方可執行。