Mac (Qoder IDE)                         Windows (MATLAB R2022b)
┌───────────────────┐                  ┌──────────────────────────────┐
│  MCP Client (HTTP)│ ─── Tailscale ──►│  matlab_mcp_server.py        │
│  Syncthing        │ ◄── P2P Sync ───►│  子进程池 + matlab -batch    │
│  Git              │                  │  17 个 MCP 工具              │
└───────────────────┘                  └──────────────────────────────┘

# 1. 安装依赖（无需 MATLAB Engine API）
pip install -r requirements.txt

# 2. 修改 .env 配置（MATLAB_WORKING_DIR、PYTHON_PATH、MCP_TOKEN 等）
#    matlab 需在 PATH 中，或通过 .env 的 MATLAB_EXE 指定

# 3. 启动服务
python matlab_mcp_server.py
# 或双击 start_server.bat

{
  "mcpServers": {
    "matlab": {
      "type": "http",
      "url": "http://100.x.y.z:8080/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

├── matlab_mcp_server.py      # 主服务（17 个 MCP 工具，~1150 行）
├── mcp_run_experiment.m      # MATLAB 实验执行器（含 manifest + 种子管理）
├── cleanup_and_start.py      # 安全启动器（清理残留的 matlab -batch 进程）
├── config.py                 # 配置兜底（.env 为唯一权威）
├── .env                      # 环境变量配置（唯一权威，不入库）
├── requirements.txt          # Python 依赖
├── test_smoke.py             # 冒烟测试（调度器/认证/路径沙箱）
│
├── start_server.bat          # Windows 快速启动
├── install_service.bat       # NSSM 服务安装（开机自启）
├── setup_firewall.ps1        # Windows 防火墙配置
├── setup_syncthing_mac.sh    # Mac Syncthing 配置
├── setup_syncthing_win.ps1   # Windows Syncthing 配置
├── sync_and_run.sh           # Mac 一键同步+运行
├── fetch_results.sh          # Mac 结果拉取
├── test_connection.py        # 连接测试
│
├── DEPLOYMENT_GUIDE.md       # 部署操作手册（16 章）
├── SOLUTION_REPORT.md        # 方案讲解报告
├── .qoder/skills/            # Qoder AI Skill（工具选择指导）
└── .gitattributes            # Git LFS 配置

python test_smoke.py   # 冒烟测试（含调度器/认证/路径沙箱）
python test_connection.py --token YOUR_TOKEN   # 连接测试（真实握手）