远程命令 MCP 服务器

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

特性

• 跨平台命令执行
• 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. 在您的设置文件中配置 MCP 服务器：

对于 Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "remote-command": {
      "command": "node",
      "args": ["path/to/remote-command-server/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

对于 VSCode Cline 扩展 (cline_mcp_settings.json):

{
  "mcpServers": {
    "remote-command": {
      "command": "node",
      "args": ["path/to/remote-command-server/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

用法

该服务器提供了一个名为 execute_remote_command 的工具，可以在主机上执行任何有效的 shell 命令。 这包括：

• 系统命令
• 包管理器命令 (apt, yum, chocolatey 等)
• 开发工具 (git, npm, python 等)
• 文件操作
• 网络命令
• 服务管理
• 以及系统上可用的任何其他 CLI 命令

工具: execute_remote_command

参数：

• command (必需): 可以在主机操作系统上执行的任何有效的 shell 命令
• cwd (可选): 命令执行的工作目录

示例

1. 系统信息:

<use_mcp_tool>
<server_name>remote-command</server_name>
<tool_name>execute_remote_command</tool_name>
<arguments>
{
  "command": "systeminfo"  // Windows
  // or "uname -a"        // Linux
}
</arguments>
</use_mcp_tool>

2. 包管理:

<use_mcp_tool>
<server_name>remote-command</server_name>
<tool_name>execute_remote_command</tool_name>
<arguments>
{
  "command": "npm list -g --depth=0"  // 列出全局 NPM 包
}
</arguments>
</use_mcp_tool>

3. 网络操作:

<use_mcp_tool>
<server_name>remote-command</server_name>
<tool_name>execute_remote_command</tool_name>
<arguments>
{
  "command": "netstat -an"  // 显示所有网络连接
}
</arguments>
</use_mcp_tool>

4. Git 操作:

<use_mcp_tool>
<server_name>remote-command</server_name>
<tool_name>execute_remote_command</tool_name>
<arguments>
{
  "command": "git status",
  "cwd": "/path/to/repo"
}
</arguments>
</use_mcp_tool>

5. 文件操作:

<use_mcp_tool>
<server_name>remote-command</server_name>
<tool_name>execute_remote_command</tool_name>
<arguments>
{
  "command": "ls -la",  // 列出文件详细信息
  "cwd": "/path/to/directory"
}
</arguments>
</use_mcp_tool>

6. 进程管理:

<use_mcp_tool>
<server_name>remote-command</server_name>
<tool_name>execute_remote_command</tool_name>
<arguments>
{
  "command": "ps aux"  // 列出所有正在运行的进程 (Unix)
  // or "tasklist"     // Windows 等效命令
}
</arguments>
</use_mcp_tool>

7. 服务控制:

<use_mcp_tool>
<server_name>remote-command</server_name>
<tool_name>execute_remote_command</tool_name>
<arguments>
{
  "command": "systemctl status nginx"  // 检查服务状态 (Linux)
  // or "sc query nginx"               // Windows 等效命令
}
</arguments>
</use_mcp_tool>

安全注意事项

由于此服务器可以执行任何系统命令，请考虑以下安全措施：

1. 访问控制: 限制只有受信任的用户才能访问 MCP 服务器
2. 命令验证: 在应用程序逻辑中执行命令之前验证命令
3. 工作目录: 使用 cwd 参数将命令执行限制在特定目录中
4. 环境: 谨慎使用修改系统设置或敏感文件的命令
5. 权限: 使用适当的用户权限运行 MCP 服务器

跨平台命令处理

服务器自动处理平台特定的差异：

1. 命令转换:

   • ls ⟷ dir (根据平台自动转换)
   • 为每个平台正确格式化管道运算符

2. Shell 选择:

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

错误处理

服务器提供详细的错误消息，并在响应中包含 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. Fork 仓库
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 文件。