vscode-cube-mcp

# Vscode_cube_mcp [](https://github.com/h666zhang/vscode-cube-mcp) [](https://pypi.org/project/vscode-cube-mcp/) [](LICENSE) > **项目定位**：对开源社区的实际意义约等于0。 > 它存在的全部意义，是教会作者用 git，并推动作者去学习 STM32F103C8T6 与 MCP。 > 我说实话在GUI上点几下怎么你了，就要用AI生成了。我的本意是让他生成框架， > 但是AI实在是太强大了提示词给的稍微精确一点AI就自己生成完了。 ## 为什么用(用之前 vs 用之后) **用之前**：配置一个 STM32 工程，你得打开 CubeMX 图形界面——选芯片、拖时钟树、 点引脚、配外设，每一步都在 GUI 里点，重复劳动多，还容易漏。 **用之后**：在 AI 对话里直接说一句： > 「使用 vscode-cube-mcp 的内置 Tool，参考 SPL_OLED 工程下的文件； > 用 STM32F103C8T6 生成一个工程：PB14 配成 GPIO 输出（接 LED）、 > PB8 做 SCL、PB9 做 SDA 配 I2C1、TIM2 配内部时钟（1s 周期）。 > 配置到 HAL 骨架为止，LED 闪烁和 OLED 显示的业务代码我自己写。」 工具自动生成整个 HAL 工程；想改配置，继续说就行，全程不用打开 GUI。 <!-- 演示 GIF（待补）：10 秒展示「说一句话 → 工程生成完成」；作者暂无录屏环境，欢迎 PR 补充 --> MCP(Model Context Protocol) server,封装 **STM32CubeMX** 官方命令行脚本模式(`-q`), 让 AI 助手可以直接加载 .ioc 工程、改引脚/外设配置、生成 HAL 代码、导出引脚表,全程无需打开 CubeMX GUI。 > **能力边界**：本工具只生成**工程配置与 HAL 骨架**（引脚、外设、时钟、工具链）， > 不负责应用逻辑代码（LED 闪烁、OLED 显示内容、传感器驱动等）——业务代码请在生成后的工程里自己写。 ## 功能一览 | 工具 | 说明 | |------|------| | `cubemx_help` | **server 内置帮助**:工具清单、可用模板、外设配置方法(陌生 agent 建议先调用) | | `cubemx_load` | 加载 .ioc 并回读关键配置(只读) | | `cubemx_configure` | 加载 .ioc,执行 `set` 命令序列并写回 | | `cubemx_generate` | 加载 .ioc 并生成 HAL 工程 | | `cubemx_export_pinout` | 导出引脚配置 CSV(只读) | | `cubemx_new_project` | **从零生成新工程**(内置模板库,无需预先 .ioc) | | `cubemx_remove_peripheral` | 从 .ioc 移除外设 | | `cubemx_add_source` | 把自定义源文件加入 CMake 源列表 | | `cubemx_script` | 任意 CubeMX 脚本命令序列(高级/原始脚本接口) | ## 要求 - **Python >= 3.10**(Windows 建议用官方安装版,不要用 msys2/Git 自带的 python,见 FAQ) - **STM32CubeMX 6.x**(ST 专有软件,请从 [ST 官网](https://www.st.com/en/development-tools/stm32cubemx.html) 免费下载并自行遵守其许可;本工具仅运行时调用其命令行,不包含、不修改其代码) ## 快速开始(Windows) 三步,约 2 分钟。以下命令都在 **PowerShell** 里执行。 ### 第 1 步:安装 ```po…