远程命令 MCP 服务器

一个模型上下文协议（MCP）服务器，支持跨不同操作系统执行远程命令。此服务器提供统一接口来执行 shell 命令，自动处理 Windows 和 Unix-like 系统之间的平台特定差异。

特性

• 跨平台命令執行
• 自動化命令规范化以適應 Windows 和 Unix 系統之間的差異
• 內建錯誤處理和輸出流轉發
• 工作目錄指定支持
• 根據平台選擇特定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 目錄下。

使用方法

主要功能

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

  • Windows: dir
  • Unix/Linux: ls

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

使用示例

1. 基本命令執行

execute_command("ls")

2. 指定工作目錄

execute_command("ls", { cwd: "/path/to/directory" })

3. 跨平台命令轉換

execute_command("dir", { platform: "unix" }) // 自動轉換為 `ls`

4. 管道操作符支持

execute_command("ls | grep .txt", { shell: "/bin/sh" })

錯誤處理

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

{
  "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 文件。