Shell MCP Server

🚀 Shell MCP 服務器

一個基於 Node.js 實現的模型上下文協議（MCP）服務，為您提供安全的 shell 命令執行功能。該服務器允許 AI 模型在受控環境中執行 shell 命令，內置了多重安全措施。它還能輕鬆集成到 Claude Desktop，實現 Claude 與您的 shell 之間的連接。

🚀 快速開始

運行 npx mcp-shell。

若要添加到 Claude Desktop，可運行 npx mcp-shell config，或者手動將 npx -y mcp-shell 添加到配置中。

啟動（或重新啟動）Claude Desktop，您會在登錄頁面看到 MCP 工具。

✨ 主要特性

• MCP 兼容的服務器實現
• 帶有黑名單保護的安全命令執行
• 命令存在性驗證
• 標準輸入輸出（I/O）傳輸
• 錯誤處理和優雅關閉

📦 安裝指南

運行 npx mcp-shell。

要添加到 Claude Desktop，請運行 npx mcp-shell config。或者手動將 npx -y mcp-shell 添加到配置中。

啟動（或重新啟動）Claude Desktop，您應該會在登錄頁面看到 MCP 工具。

📚 詳細文檔

安全特性

該服務器實現了以下安全措施：

1. 命令黑名單保護
   • 阻止危險的系統命令執行
   • 防止對關鍵系統修改的訪問
   • 保護文件系統免受破壞
   • 防止權限提升攻擊
2. 命令驗證
   • 執行前驗證命令是否存在
   • 對黑名單進行檢查
   • 返回清晰的錯誤消息以響應無效命令

可用工具

服務器提供一個工具：

run_command

執行 shell 命令並返回其輸出。 輸入格式：

{
  "type": "object",
  "properties": {
    "command": { "type": "string" }
  }
}

響應：

• 成功：命令輸出作為純文本
• 錯誤：錯誤消息作為純文本

黑名單命令

以下命令類別被阻止以確保安全：

• 文件系統破壞命令（rm, rmdir, del）
• 磁盤/文件系統命令（format, mkfs, dd）
• 權限/所有權命令（chmod, chown）
• 特權提升命令（sudo, su）
• 代碼執行命令（exec, eval）
• 系統通信命令（write, wall）
• 系統控制命令（shutdown, reboot, init）

錯誤處理

服務器包含全面的錯誤處理：

• 命令未找到錯誤
• 黑名單命令錯誤
• 執行錯誤
• MCP 協議錯誤
• 收到 SIGINT 信號時優雅關閉

實現細節

服務器使用以下技術構建：

• 模型上下文協議 SDK
• StdioServerTransport 進行通信
• 使用 execa 執行命令
• 使用 command-exists 驗證命令是否存在

開發說明

要修改安全設置，可以執行以下操作：

1. 編輯 BLACKLISTED_COMMANDS 集合以調整被阻止的命令
2. 修改 validateCommand 函數以添加額外的驗證規則
3. 改進 CallToolRequestSchema 處理器中的命令解析邏輯