Remote Command

🚀 遠程命令 MCP 服務器

遠程命令 MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它支持在不同操作系統間遠程執行命令。該服務器提供了統一的接口來執行 shell 命令，還能自動處理 Windows 和 Unix-like 系統之間的平臺差異，極大地提升了跨系統操作的便利性。

🚀 快速開始

遠程命令 MCP 服務器可以讓你在不同操作系統之間輕鬆實現遠程命令執行。下面為你介紹如何快速搭建並使用該服務器。

✨ 主要特性

• 🌐 跨平臺命令執行：支持在不同操作系統之間執行命令。
• ⚙️ Windows 和 Unix 之間的命令自動標準化：自動處理不同系統間命令差異。
• 🛠️ 內建錯誤處理和詳細錯誤訊息：提供詳細的錯誤信息，方便排查問題。
• 📤 包含 stdout 和 stderr 的回應：完整反饋命令執行結果。
• 📁 遷移命令執行限制到特定目錄：可指定命令執行的目錄。
• 🖥️ 根據平臺選擇合適的 Shell：自動適配不同系統的 Shell。

📦 安裝指南

按照以下步驟安裝遠程命令 MCP 服務器：

1. 下載項目代碼。
2. 變更工作目錄到項目根目錄。
3. 執行安裝命令：

npm install

4. 建立可執行文件：

npm run build

💻 使用示例

基礎用法

使用 execute_remote_command 工具執行命令。以下是一些使用示例：

示例 1：執行 ls 在 Unix 系統，等同於 dir 在 Windows

execute_remote_command({
  command: "list",
  cwd: "."
});

示例 2：查詢 .disk 文件

execute_remote_command({
  command: "find . -name '*.disk'",
  cwd: "/home/user"
});

📚 詳細文檔

安全注意事項

為確保服務器的安全使用，請遵循以下注意事項：

1. 限制命令執行目錄使用 cwd。
2. 避免執行具有提升權限的命令。
3. 控制 MCP 服務器的訪問權限。
4. 監控敏感操作。

平臺命令處理

命令轉換

不同系統之間的命令轉換關係如下：

• ls ↔ dir
• cp ↔ copy
• rm ↔ del

Shell

不同系統使用的 Shell 如下：

• Windows: cmd.exe
• Unix/Linux: /bin/sh

錯誤處理

服務器提供詳細錯誤訊息，包含在回應中。如果命令失敗，您將收到錯誤訊息，其中包含有關出錯的詳細信息。示例錯誤回應如下：

{
  "content": [
    {
      "type": "text",
      "text": "命令執行錯誤：命令以退出代碼 1 失敗"
    }
  ],
  "isError": true
}

開發

項目結構

remote-command-server/
├── src/
│   └── index.ts    # 主服務器實現
├── package.json
├── tsconfig.json
└── README.md

構建

執行以下命令編譯 TypeScript 代碼並在 build 目錄中創建可執行文件：

npm run build

貢獻指南

歡迎為項目做出貢獻，貢獻步驟如下：

1. 分叉項目庫。
2. 創建功能分支 (git checkout -b feature/amazing-feature)。
3. 提交更改 (git commit -m '添加一些驚人的功能')。
4. 推送到分支 (git push origin feature/amazing-feature)。
5. 開啟 Pull Request。

📄 許可證

此項目遵循 MIT 許可證 - 請參閱 LICENSE 文件以獲取細節。