远程命令 MCP 服务器

一个 Model Context Protocol (MCP) 服务器，支持在不同操作系统之间远程执行命令。该服务器提供统一接口以执行 shell 命令，自动处理 Windows 和 Unix-like 系统之间的平台差异。

特性

• 跨平台命令執行
• Windows 和 Unix 之間的命令自動標準化
• 內建錯誤處理和詳細錯誤訊息
• 包含_stdout_ 和 stderr 的回應
• 遷移命令執行限制到特定目錄
• 根據平台選擇合適的 Shell

安裝步驟

1. 下載專案代碼

2. 變更工作目錄到專案根目錄

3. 執行安裝命令：

   npm install
   

4. 建立可執行文件：

   npm run build
   

開啟服務器

node build/index.js

使用方法

主要工具

execute_remote_command

參數

• command: 要執行的命令（必填）
• cwd: 命令執行的工作目錄（可選，默认為當前目錄）

示例

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 

- Windows: `cmd.exe`
- Unix/Linux: `/bin/sh`

## 錯誤處理

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

示例錯誤回應：
```json
{
  "content": [
    {
      "type": "text",
      "text": "命令執行錯誤：命令以退出代碼 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 '添加一些驚人的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 開啟 Pull Request

授權條款

此專案icensed under the MIT License - 請參閱 LICENSE 文件以获取細節。