Commandexecution

🚀 命令執行 MCP 服務器 - Claude Desktop 版本

命令執行 MCP（模型上下文協議）服務器是一款安全可控的工具，它能讓 Claude 直接在您的本地系統上執行 shell 命令。藉助該服務器，您可以通過 Claude 的界面，安全靈活地與計算機的命令行進行交互。

🚀 快速開始

命令執行 MCP 服務器允許 Claude 直接在本地系統執行 shell 命令，通過安全且靈活的方式，實現與計算機命令行的交互。

✨ 主要特性

• 安全命令執行：帶內置安全檢查的 shell 命令執行。
• 工作目錄支持：可在特定目錄中執行命令。
• 跨平臺兼容性：適用於 macOS 和其他類 Unix 系統。
• 全面錯誤處理：提供詳細的命令執行反饋。
• 超時和緩衝區限制：防止長時間運行或資源密集型的命令。

🔧 技術細節

服務器實現了多層安全保護：

1. 危險命令阻止
   • 防止執行可能具有危害性的命令，如 rm -rf、sudo 等。
   • 阻止會危及系統完整性執行的命令。
2. 執行限制
   • 最大執行時間：30 秒。
   • 最大輸出緩衝區大小：1MB。
   • 驗證工作目錄存在性。

📦 安裝指南

1. 先決條件

• Node.js (v16 或更高版本)
• Claude Desktop
• npm (Node 包管理器)

2. 安裝依賴項

cd /path/to/command-execution-tool
npm install @modelcontextprotocol/sdk

3. 配置 Claude Desktop

將以下內容添加到您的 Claude Desktop 配置文件中：

• 位置：
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
• 配置塊：

{
  "mcpServers": {
    "command-execution": {
      "command": "node",
      "args": [
        "/full/path/to/command-execution-tool.js"
      ],
      "env": {
        "NODE_OPTIONS": "--no-deprecation"
      }
    }
  }
}

注意：將 /full/path/to/command-execution-tool.js 替換為您實際的腳本路徑。

💻 使用示例

支持工具

1. execute-command

在可選的工作目錄中執行 shell 命令。

• 參數：
  • command (必需): 要執行的 shell 命令。
  • workingDirectory (可選): 指定命令執行的目錄。
• Claude 中示例用法：

execute-command with command="ls -la" and workingDirectory="/Users/yourusername/Documents"

2. simple-hello

一個基本演示工具，返回問候語。

• 參數：
  • name (可選): 要問候的姓名（默認為 "World"）。
• Claude 中示例用法：

simple-hello with name="Claude"

📚 詳細文檔

使用指南

• 謹慎行事：只運行您理解的命令。
• 安全第一：工具阻止顯然危險的命令。
• 工作目錄：指定工作目錄以獲得更受控的執行環境。

侷限性

• 不支持交互式命令。
• 最大命令執行時間是 30 秒。
• 輸出限制為 1MB。
• 阻止一些系統關鍵命令。

貢獻

歡迎貢獻！請通過提交拉取請求或在 GitHub 倉庫中打開問題。

支持

有關問題或功能請求，請在 GitHub 上打開一個問題。

📄 許可證

MIT 許可證