{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_zy6yypeqm2vp","handle":"vscode-cube-mcp","url":"https://wellknown.network/agents/vscode-cube-mcp","links":{"self":"https://wellknown.network/agents/vscode-cube-mcp/record.json","html":"https://wellknown.network/agents/vscode-cube-mcp","markdown":"https://wellknown.network/agents/vscode-cube-mcp/record.md","api":"https://wellknown.network/api/v1/agents/vscode-cube-mcp","status":"https://wellknown.network/api/v1/agents/vscode-cube-mcp/status","claim":"https://wellknown.network/agents/vscode-cube-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/vscode-cube-mcp/claim.json","badge":"https://wellknown.network/agents/vscode-cube-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:vscode-cube-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"vscode-cube-mcp","summary":"MCP server 封装 STM32CubeMX 命令行,通过 MCP 工具配置引脚/外设并生成 HAL 工程","description":"# Vscode_cube_mcp \n \n[![GitHub](https://img.shields.io/badge/GitHub-h666zhang%2Fvscode--cube--mcp-181717%3Flogo%3Dgithub)](https://github.com/h666zhang/vscode-cube-mcp)  [![PyPI](https://img.shields.io/pypi/v/vscode-cube-mcp)](https://pypi.org/project/vscode-cube-mcp/)  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) \n \n> **项目定位**：对开源社区的实际意义约等于0。 \n> 它存在的全部意义，是教会作者用 git，并推动作者去学习 STM32F103C8T6 与 MCP。 \n> 我说实话在GUI上点几下怎么你了，就要用AI生成了。我的本意是让他生成框架， \n> 但是AI实在是太强大了提示词给的稍微精确一点AI就自己生成完了。 \n \n## 为什么用(用之前 vs 用之后) \n \n**用之前**：配置一个 STM32 工程，你得打开 CubeMX 图形界面——选芯片、拖时钟树、 \n点引脚、配外设，每一步都在 GUI 里点，重复劳动多，还容易漏。 \n \n**用之后**：在 AI 对话里直接说一句： \n \n> 「使用 vscode-cube-mcp 的内置 Tool，参考 SPL_OLED 工程下的文件； \n> 用 STM32F103C8T6 生成一个工程：PB14 配成 GPIO 输出（接 LED）、 \n> PB8 做 SCL、PB9 做 SDA 配 I2C1、TIM2 配内部时钟（1s 周期）。 \n> 配置到 HAL 骨架为止，LED 闪烁和 OLED 显示的业务代码我自己写。」 \n \n工具自动生成整个 HAL 工程；想改配置，继续说就行，全程不用打开 GUI。 \n \n<!-- 演示 GIF（待补）：10 秒展示「说一句话 → 工程生成完成」；作者暂无录屏环境，欢迎 PR 补充 --> \n \nMCP(Model Context Protocol) server,封装 **STM32CubeMX** 官方命令行脚本模式(`-q`), \n让 AI 助手可以直接加载 .ioc 工程、改引脚/外设配置、生成 HAL 代码、导出引脚表,全程无需打开 CubeMX GUI。 \n \n> **能力边界**：本工具只生成**工程配置与 HAL 骨架**（引脚、外设、时钟、工具链）， \n> 不负责应用逻辑代码（LED 闪烁、OLED 显示内容、传感器驱动等）——业务代码请在生成后的工程里自己写。 \n \n## 功能一览 \n \n| 工具 | 说明 | \n|------|------| \n| `cubemx_help` | **server 内置帮助**:工具清单、可用模板、外设配置方法(陌生 agent 建议先调用) | \n| `cubemx_load` | 加载 .ioc 并回读关键配置(只读) | \n| `cubemx_configure` | 加载 .ioc,执行 `set` 命令序列并写回 | \n| `cubemx_generate` | 加载 .ioc 并生成 HAL 工程 | \n| `cubemx_export_pinout` | 导出引脚配置 CSV(只读) | \n| `cubemx_new_project` | **从零生成新工程**(内置模板库,无需预先 .ioc) | \n| `cubemx_remove_peripheral` | 从 .ioc 移除外设 | \n| `cubemx_add_source` | 把自定义源文件加入 CMake 源列表 | \n| `cubemx_script` | 任意 CubeMX 脚本命令序列(高级/原始脚本接口) | \n \n## 要求 \n \n- **Python >= 3.10**(Windows 建议用官方安装版,不要用 msys2/Git 自带的 python,见 FAQ) \n- **STM32CubeMX 6.x**(ST 专有软件,请从 [ST 官网](https://www.st.com/en/development-tools/stm32cubemx.html) 免费下载并自行遵守其许可;本工具仅运行时调用其命令行,不包含、不修改其代码) \n \n## 快速开始(Windows) \n \n三步,约 2 分钟。以下命令都在 **PowerShell** 里执行。 \n \n### 第 1 步:安装 \n \n```po…","publisher":{"name":"F1ZyCaO_3286","url":null},"homepage":null,"repository":null,"version":"0.4.2","license":"MIT","protocols":["mcp"],"tags":["mcp","stm32","stm32cubemx","embedded","hal"],"pricing":null,"endpoints":[{"url":"pypi:vscode-cube-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"fr"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"vscode-cube-mcp","registry":"pypi","observedAt":"2026-09-10T15:25:18.272Z","publishedAt":"2026-08-27T10:55:37.086264Z","latestVersion":"0.4.2"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"vscode-cube-mcp","url":"https://pypi.org/project/vscode-cube-mcp/","firstSeenAt":"2026-09-10T15:23:56.974Z","fetchedAt":"2026-09-10T15:23:56.974Z","normalizedAt":"2026-09-10T15:23:56.974Z"}]},"firstSeenAt":"2026-09-10T15:23:56.974Z","updatedAt":"2026-09-10T15:25:18.272Z"}