CloudBuilder MCP 远程编译工具

一个基于模型上下文协议（MCP）的服务器，提供完整的云端构建工作流支持。通过 rclone 实现文件同步、远程命令执行和自动化构建，帮助开发者实现本地开发、远程构建的云端开发模式。

✨ 使用效果

图片里展示了 CloudBuilder 远程编译/同步工作流的完整执行日志，可以把它当成“本地写代码 → 自动同步到远程 Linux 机 → 远程编译 → 出错 → 本地改完再同步 → 编译通过”的闭环。

✨ 核心功能

📁 目录同步：智能同步本地目录到远程服务器，支持忽略规则和增量更新
📤 文件上传：快速上传单个文件到远程服务器
📖 文件读取：从远程服务器读取文件内容，支持多种编码格式
🖥️ 远程命令执行：通过 SSH 在远程服务器上执行命令
📋 目录浏览：列出远程目录内容，查看文件详细信息
🔧 自动化构建：支持同步后自动构建，并可自动修复编译错误
⚙️ 灵活配置：支持项目级配置和环境变量配置

🚀 快速开始

前置要求

Python 3.12 或更高版本
rclone（用于文件传输操作，支持多种后端如 SFTP、S3、FTP 等）
MCP 客户端（如 Claude Desktop、Cursor 等）

安装依赖

方法一：使用 pip（推荐）

pip install -r requirements.txt

方法二：使用 uv

uv sync

配置 rclone

安装 rclone：从 rclone 官网下载并安装
配置

界面方式：

界面下载：https://github.com/rclone/rclone-webui-react

加载命令：rclone rcd --rc-web-gui --rc-user=abc --rc-pass=abcd ./ui

然后界面进行配置。
命令行方式：

配置远程存储：运行 rclone config 创建远程配置。rclone 支持多种后端类型（SFTP、S3、FTP、Google Drive 等）
```
rclone config
```
SFTP 配置示例：
```
[route84]
type = sftp
host = 192.0.0.1
user = xxxx
pass = <obscured_password>  # 使用 rclone obscure 加密的密码
shell_type = unix
port = 22  # 可选，默认为 22
```
注意：rclone 支持多种存储后端，您可以根据需要配置 SFTP、S3、FTP 等不同类型的远程存储。

配置文件位置：rclone 会自动查找配置文件，查找顺序：
- 环境变量 RCLONE_CONFIG 指定的路径
- 当前工作目录中的 rclone.conf
- Python 脚本目录中的 rclone.conf
- Windows: %APPDATA%\rclone\rclone.conf
- Linux/Mac: ~/.config/rclone/rclone.conf 或 ~/.rclone.conf

配置 MCP 客户端

在 MCP 客户端配置文件中添加服务器配置（以 Claude Desktop 为例，配置文件通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json 或 Windows 的对应位置）：

{
  "mcpServers": {
    "cloud-builder": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/cloud-builder",
        "run",
        "python",
        "src/main.py"
      ],
      "env": {
        "RCLONE_EXE