{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3c8f8w2syaj7","handle":"stm32-mcp","url":"https://wellknown.network/agents/stm32-mcp","links":{"self":"https://wellknown.network/agents/stm32-mcp/record.json","html":"https://wellknown.network/agents/stm32-mcp","markdown":"https://wellknown.network/agents/stm32-mcp/record.md","api":"https://wellknown.network/api/v1/agents/stm32-mcp","status":"https://wellknown.network/api/v1/agents/stm32-mcp/status","claim":"https://wellknown.network/agents/stm32-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/stm32-mcp/claim.json","badge":"https://wellknown.network/agents/stm32-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/stm32-mcp/history","tools":"https://wellknown.network/api/v1/agents/stm32-mcp/tools"},"ard":{"identifier":"urn:air::server:stm32-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"stm32-mcp","summary":"STM32 MCP Build & Flash Server - AI-powered embedded development","description":"# STM32 MCP Build Server\n\n> ⚠️ **架构升级通知**: 当前版本 (v1.0) 采用\"复制代码到项目\"的安装方式。\n> v2.0 将重构为 **`uvx` + Docker** 标准架构，实现零安装、零污染。\n> 详见 [ARCHITECTURE.md](ARCHITECTURE.md) 和 [Issue #1](https://github.com/legogogoagent/STM32-Complier-MCP/issues/1)。\n\nAI自动编译修复系统 - 基于 MCP (Model Context Protocol) 的 STM32 开发平台\n\n## 🎯 项目目标\n\n构建 MCP Server，实现完整的嵌入式开发闭环：\n\n```\nAgent修改代码 → Build MCP编译 → 解析错误自动修复 → 编译成功 → Flash MCP烧录 → MCU运行\n```\n\n## 🏗️ 架构版本\n\n### v1.0 (当前版本)\n\n安装方式：复制MCP代码到用户项目 + `pip install`\n\n```json\n{\n  \"mcpServers\": {\n    \"stm32-build\": {\n      \"command\": \"python3\",\n      \"args\": [\"-m\", \"mcp_build.stm32_build_server\"]\n    }\n  }\n}\n```\n\n**已知问题** (详见 [Issue #1](https://github.com/legogogoagent/STM32-Complier-MCP/issues/1)):\n- 需要手动安装ARM工具链\n- Makefile兼容性问题 (Windows路径、GCC版本)\n- 安装步骤繁琐 (6步, >20分钟首次安装)\n- 往用户项目复制代码 (非行业标准)\n\n### v2.0 (开发中 → `feature/uvx-docker-refactor`)\n\n安装方式：`uvx` + Docker，**零安装、零污染**\n\n```json\n{\n  \"mcpServers\": {\n    \"stm32\": {\n      \"command\": \"uvx\",\n      \"args\": [\"stm32-mcp\"]\n    }\n  }\n}\n```\n\n**改进**:\n- ✅ 不复制代码到用户项目\n- ✅ 不污染用户Python环境\n- ✅ 预构建Docker镜像 (`legogogoagent/stm32-toolchain:12.3`)\n- ✅ Makefile自动修复 (容器内临时副本)\n- ✅ 符合MCP行业标准 (Playwright MCP、SQLite MCP同款模式)\n\n详见 [ARCHITECTURE.md](ARCHITECTURE.md)\n\n---\n\n## 🚀 快速开始 (v1.0)\n\n> 以下为 v1.0 安装方式。v2.0 发布后将大幅简化。\n\n### 1. 构建 Docker 镜像\n\n```bash\ndocker build -f docker/Dockerfile -t stm32-toolchain:latest .\n```\n\n### 2. 验证镜像\n\n```bash\ndocker run --rm stm32-toolchain:latest arm-none-eabi-gcc --version\ndocker run --rm stm32-toolchain:latest make --version\n```\n\n### 3. 安装依赖\n\n```bash\npip install -r requirements.txt\n```\n\n### 4. 启动 MCP Server\n\n```bash\n# STDIO 模式\npython -m mcp_build.stm32_build_server\n\n# 或使用 MCP Inspector 调试\nuv run mcp dev mcp_build/stm32_build_server.py\n```\n\n### 5. Agent 调用示例\n\n```python\nfrom agents import Agent\nfrom agents.mcp import MCPServerStdio\n\nasync def main():\n    async with MCPServerStdio(\n        command=\"python\",\n        args=[\"-m\", \"mcp_build.stm32_build_server\"],\n        cwd=\"/path/to/your-project\",\n    ) as mcp_server:\n…","publisher":{"name":"legogogoagent","url":null},"homepage":"https://github.com/legogogoagent/STM32-Complier-MCP","repository":"https://github.com/legogogoagent/STM32-Complier-MCP","version":"2.0.0","license":null,"protocols":["mcp"],"tags":["arm","compiler","embedded","flash","mcp","stm32"],"pricing":null,"endpoints":[{"url":"pypi:stm32-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.779,"provenance":"derived"}],"categories":["dev"],"language":"en"},"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":"stm32-mcp","registry":"pypi","observedAt":"2026-11-04T01:24:55.930Z","publishedAt":"2026-02-13T06:24:49.194814Z","latestVersion":"2.0.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"stm32-mcp","url":"https://pypi.org/project/stm32-mcp/","firstSeenAt":"2026-09-10T13:19:44.528Z","fetchedAt":"2026-11-04T01:23:51.357Z","normalizedAt":"2026-11-04T01:23:51.357Z"}]},"firstSeenAt":"2026-09-10T13:19:44.528Z","updatedAt":"2026-11-04T01:24:55.930Z"}