Remote Command MCP

🚀 远程命令 MCP 服务器

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

🚀 快速开始

远程命令 MCP 服务器允许你跨不同操作系统执行远程命令，自动处理平台差异。以下是开始使用的步骤：

✨ 主要特性

• 跨平台命令执行：可在不同操作系统上执行命令。
• 自动化命令规范化：自动适应 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" })

📚 详细文档

主要功能

• 跨平台命令执行：自动转换平台特定命令，例如：

  • 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 文件。