stm32-mcp

# STM32 MCP Build Server > ⚠️ **架构升级通知**: 当前版本 (v1.0) 采用"复制代码到项目"的安装方式。 > v2.0 将重构为 **`uvx` + Docker** 标准架构，实现零安装、零污染。 > 详见 [ARCHITECTURE.md](ARCHITECTURE.md) 和 [Issue #1](https://github.com/legogogoagent/STM32-Complier-MCP/issues/1)。 AI自动编译修复系统 - 基于 MCP (Model Context Protocol) 的 STM32 开发平台 ## 🎯 项目目标 构建 MCP Server，实现完整的嵌入式开发闭环： ``` Agent修改代码 → Build MCP编译 → 解析错误自动修复 → 编译成功 → Flash MCP烧录 → MCU运行 ``` ## 🏗️ 架构版本 ### v1.0 (当前版本) 安装方式：复制MCP代码到用户项目 + `pip install` ```json { "mcpServers": { "stm32-build": { "command": "python3", "args": ["-m", "mcp_build.stm32_build_server"] } } } ``` **已知问题** (详见 [Issue #1](https://github.com/legogogoagent/STM32-Complier-MCP/issues/1)): - 需要手动安装ARM工具链 - Makefile兼容性问题 (Windows路径、GCC版本) - 安装步骤繁琐 (6步, >20分钟首次安装) - 往用户项目复制代码 (非行业标准) ### v2.0 (开发中 → `feature/uvx-docker-refactor`) 安装方式：`uvx` + Docker，**零安装、零污染** ```json { "mcpServers": { "stm32": { "command": "uvx", "args": ["stm32-mcp"] } } } ``` **改进**: - ✅ 不复制代码到用户项目 - ✅ 不污染用户Python环境 - ✅ 预构建Docker镜像 (`legogogoagent/stm32-toolchain:12.3`) - ✅ Makefile自动修复 (容器内临时副本) - ✅ 符合MCP行业标准 (Playwright MCP、SQLite MCP同款模式) 详见 [ARCHITECTURE.md](ARCHITECTURE.md) --- ## 🚀 快速开始 (v1.0) > 以下为 v1.0 安装方式。v2.0 发布后将大幅简化。 ### 1. 构建 Docker 镜像 ```bash docker build -f docker/Dockerfile -t stm32-toolchain:latest . ``` ### 2. 验证镜像 ```bash docker run --rm stm32-toolchain:latest arm-none-eabi-gcc --version docker run --rm stm32-toolchain:latest make --version ``` ### 3. 安装依赖 ```bash pip install -r requirements.txt ``` ### 4. 启动 MCP Server ```bash # STDIO 模式 python -m mcp_build.stm32_build_server # 或使用 MCP Inspector 调试 uv run mcp dev mcp_build/stm32_build_server.py ``` ### 5. Agent 调用示例 ```python from agents import Agent from agents.mcp import MCPServerStdio async def main(): async with MCPServerStdio( command="python", args=["-m", "mcp_build.stm32_build_server"], cwd="/path/to/your-project", ) as mcp_server: …