Remote Command MCP

🚀 遠程命令 MCP 服務器

這是一個模型上下文協議（MCP）服務器，支持在不同操作系統上執行遠程命令。它提供了統一的接口來執行 shell 命令，能自動處理 Windows 和 Unix-like 系統之間的平臺特定差異，為跨平臺操作帶來便利。

🚀 快速開始

本服務器可以讓你在不同操作系統上輕鬆執行遠程命令，通過統一接口屏蔽了平臺間的差異。

✨ 主要特性

• 🌐 跨平臺命令執行：支持在不同操作系統上執行命令。
• ⚙️ 自動化命令規範化：自動處理 Windows 和 Unix 系統之間的命令差異。
• 🛠️ 內建錯誤處理和輸出流轉發：提供詳細的錯誤信息和輸出結果。
• 📂 工作目錄指定支持：可指定命令執行的工作目錄。
• 🖥️ 根據平臺選擇特定 shell：靈活適配不同平臺的 shell。

📦 安裝指南

1. 克隆倉庫：

git clone https://github.com/deepsuthar496/Remote-Command-MCP
cd remote-command-server

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

4. 配置配置文件：
   • Windows 系統：將配置寫入 config.json 文件中，並放在 src 目錄下。
   • Unix/Linux 系統：將配置寫入 config.json 文件中，並放在 src 目錄下。

💻 使用示例

基礎用法

本服務器提供了多種功能，以下是一些基本的使用示例：

# 基本命令執行
execute_command("ls")

# 指定工作目錄
execute_command("ls", { cwd: "/path/to/directory" })

# 跨平臺命令轉換
execute_command("dir", { platform: "unix" }) // 自動轉換為 `ls`

# 管道操作符支持
execute_command("ls | grep .txt", { shell: "/bin/sh" })

高級用法

本服務器還支持跨平臺命令執行和錯誤處理等高級功能：

• 跨平臺命令執行：自動轉換平臺-specific 命令，例如：

  • Windows: dir
  • Unix/Linux: ls

• 錯誤處理：提供詳細的錯誤信息，包括 stdout 和 stderr 的輸出。

如果命令執行失敗，將會收到錯誤信息：

{
  "content": [
    {
      "type": "text",
      "text": "Command execution error: Command failed with exit code 1"
    }
  ],
  "isError": true
}

🔧 技術細節

項目結構

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

構建命令

npm run build

此命令會編譯 TypeScript 代碼並在 build 目錄中生成執行文件。

🤝 貢獻指南

1. 分叉倉庫
2. 創建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 開啟 Pull Request

📄 許可證

此項目遵從 MIT License，具體內容請參閱 LICENSE 文件。