mcp-visual-programming-pc-client/
├── README.md                              # 本文档（极简快速开始）
├── docs/                                  # 细化的具体方案与技术规范文档
│   ├── 01_Architecture_Design.md         # 架构设计方案与 Qt 线程安全通信机制 (QThread + Signals)
│   ├── 02_MCP_Tools_Specification.md      # 7 大 MCP 工具接口定义与参数规范
│   ├── 03_CModel_Parsing_Guide.md         # cmodel 模型文件解析与画布拓扑映射指南
│   └── 04_Deployment_and_Integration.md   # 部署方式、PyInstaller 打包与 IDE 接入指南
├── src/                                   # 模块化核心源代码
│   ├── model_parser/                      # cmodel 模型文件解析模块 (CModelReader)
│   │   └── cmodel_reader.py
│   └── qt_client/                         # Qt 界面与内嵌 MCP 引擎通信模块
│       ├── main_window.py                 # Qt 主窗口与 QGraphicsScene 画布
│       └── mcp_thread.py                  # FastMCP 线程与 pyqtSignal 跨线程桥梁
├── resources/                             # 示例资源文件
│   ├── sample_model.cmodel.json           # 示例机器人 cmodel 模型文件
│   └── mcp_config_example.json            # IDE (Cursor/Claude/Trae) 接入配置文件
├── run_qt_client.py                       # 客户端程序一键启动入口
└── requirements.txt                       # 依赖清单 (PyQt6, FastMCP, uvicorn)

git clone https://github.com/doghelWang/mcp-visual-programming-pc-client.git
cd mcp-visual-programming-pc-client

# 1. 安装依赖
pip install -r requirements.txt

# 2. 运行 Qt 图形化客户端
python3 run_qt_client.py

{
  "mcpServers": {
    "qt-visual-programming-client": {
      "command": "python3",
      "args": [
        "/Users/wangfeifei/code/mcp-visual-programming-pc-client/run_qt_client.py"
      ],
      "env": {
        "AMR_MODEL_FILE": "/Users/wangfeifei/code/mcp-visual-programming-pc-client/resources/sample_model.cmodel.json"
      }
    }
  }
}