Command Executor MCP Server

🚀 命令執行器 MCP 服務器

命令執行器 MCP 服務器是一款用於安全執行預批准命令的工具，藉助預批准命令列表和一系列安全措施，有效保障命令執行的安全性，同時支持通過環境變量進行靈活配置，能與 Claude Desktop 無縫集成。

🚀 快速開始

A Model Context Protocol 服務器用於安全地執行預批准命令。您可參考以下步驟進行操作：

1. 安裝依賴：

npm install

2. 構建服務器：

npm run build

3. 若需使用開發模式（自動重建），可執行：

npm run watch

✨ 主要特性

• 安全執行：使用預批准命令列表，確保只有經過允許的命令才能被安全執行。
• 靈活配置：可通過環境變量配置允許的命令，滿足不同場景需求。
• 技術棧先進：使用 TypeScript 和 MCP SDK 構建，保證代碼的可維護性和性能。
• 無縫集成：通過 stdio 進行通信，實現與其他系統的無縫集成。
• 穩定可靠：具備錯誤處理和安全驗證機制，保障系統穩定運行。
• 即時反饋：提供即時命令輸出流，方便用戶及時掌握命令執行情況。

📦 安裝指南

安裝依賴

npm install

構建服務器

npm run build

開發模式（自動重建）

npm run watch

📚 詳細文檔

🔧 配置說明

🔒 允許的命令

默認允許以下命令：

• git
• ls
• mkdir
• cd
• npm
• npx
• python

您可以通過設置 ALLOWED_COMMANDS 環境變量自定義允許的命令，示例如下：

export ALLOWED_COMMANDS=git,ls,mkdir,python

🔌 Claude 桌面集成

要與 Claude Desktop 一起使用，請添加服務器配置：

• MacOS：配置文件路徑為 ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：配置文件路徑為 %APPDATA%/Claude/claude_desktop_config.json

配置示例：

{
  "mcpServers": {
    "command-executor": {
      "command": "/path/to/command-executor/build/index.js"
    }
  }
}

🛡️ 安全考慮

命令執行器服務器實現了多項安全措施，保障系統安全：

1. 預批准命令列表
   • 只有顯式允許的命令才能執行，默認列表嚴格且注重安全。
   • 命令通過前綴驗證以防止注入。
2. 命令驗證
   • 命令前綴驗證防止命令注入，不使用 shell 執行，提高安全性。
   • 環境變量經過適當清理。
3. 運行時安全
   • 使用 CAP（容器化應用保護）策略限制進程權限。
   • 以非 root 用戶身份運行，防止路徑遍歷攻擊。

🛠️ 構建說明

要構建命令執行器，請使用 Node.js 和 npm，執行以下命令：

npm install
npm run build

🤝 貢獻指南

1. 叉克隆倉庫。
2. 創建功能分支。
3. 提交更改。
4. 推送到分支。
5. 創建新的拉取請求。

📄 許可證

本項目根據 MIT 許可證發佈 - 請查看 LICENSE 文件以獲取詳細信息。

🎥 演示

您可以點擊以下鏈接查看演示： 演示鏈接