wokwi MCP

电路分析仪

AI驱动的电路故障检测工具，用于分析Wokwi项目和KiCad设计中的布线错误、代码错误、组件问题以及跨多个板平台的设计意图不匹配。

这和Wokwi Pro有什么不同？

Wokwi=“运行你的电路” | 此工具=“找出电路的问题所在”

它们是互补的——在Wokwi上构建，然后在构建物理电路之前将URL粘贴在这里以查找故障。

特性

岩心分析

• 电路分析 --检测接线故障、连接缺失、极性错误和电源问题
• 代码分析 --查找草图错误和电路布线的交叉引用
• 库验证 --检查14个流行库是否缺少init调用、参数错误和常见错误
• 修复建议 --根据检测到的故障生成正确的代码和接线

KiCad EDA支持

• 原理图分析（.kicad_sch） --ERC检查、未连接的引脚、重复参考、电源标志问题、电压失配、去耦电容器检查、LED电阻器检查、UART交叉检测、极性验证、引脚功能失配检测
• PCB布局分析（.kicad_PCB） --DRC检查、未布线网、轨迹宽度验证、通过钻孔尺寸检查、间隙违规、电源轨迹宽度分析
• PCB交叉参考示意图 --检测原理图中但PCB中缺失的组件，反之亦然
• 拖放上传 --通过拖放或文件选择器上传.kicad_sch、.kicad_pcb、.kicat_pro文件
• 统一仪表板 --模式切换，在Wokwi URL分析和KiCad文件上传之间切换

设计意图分析

• 设计说明 --可选文本区域，用户可以在其中描述他们的电路应该做什么，包括特定的引脚分配
• 意图不匹配检测 --AI将实际接线/代码与声明的意图进行比较，并标记功能不匹配，即使在电气有效的情况下也是如此（例如，GPIO5上的传感器而不是GPIO4上的传感器）
• 可在两种模式下工作 --可用于Wokwi和KiCad分析

平台支持

• 多板支持 --Arduino（Uno/Mega/Nano）、ESP32、Raspberry Pi Pico、ATtiny85、STM32 Bluepill
• 无线模块支持 --蓝牙（HC-05/06、HM-10）、WiFi（ESP-01）、射频（nRF24L01）、红外

基础设施

• 双模式 -作为REST API（web应用程序）或MCP服务器运行（用于Claude Desktop/AI代理）
• 认证 --电子邮件/密码注册+使用JWT令牌登录Google OAuth
• 分析历史 --使用完整报告查看、项目类型徽章存储每个用户的过去分析
• 用户配置文件 --支持更改密码的个人资料页面

支持的板

支持的无线模块

图书馆知识库（14个图书馆）

KiCad分析能力

基于规则的检查示意图（14次检查）

基于PCB规则的检查（6次检查）

人工智能驱动的深度分析

• 使用GPT-4o进行基于规则的检查之外的分析
• 检测信号完整性问题、热问题、EMC问题
• 对照PCB布局交叉引用示意图
• 将实际设计与用户声明的意图（设计描述）进行比较

技术栈

后端： Python、FastAPI、SQLAlchemy（异步SQLite）、OpenAI GPT-4o/4o mini、Python jose（JWT）、谷歌认证

前端： React 19、Vite、Axios、React-router-dom、@React-oauth/google

MCP： FastMCP over stdio

建筑

                    ┌─────────────────────────────────────────────┐
                    │              Frontend (React 19 + Vite)     │
                    │                                             │
                    │  UrlInput ─┐                                │
                    │            ├─► Dashboard ──► FaultReport    │
                    │  KiCadUpload┘    │    │ ──► CircuitViewer   │
                    │  (mode toggle)   │    │ ──► SchematicViewer │
                    │                  │    │ ──► CodeView        │
                    │  Design          │    │ ──► FixSuggestion   │
                    │  Description ────┘    │ ──► SummaryBar      │
                    │                       │                     │
                    │  Auth ── LoginPage ── ProtectedRoute        │
                    │  Pages ── HistoryPage ── HistoryDetailPage  │
                    └──────────────┬──────────────────────────────┘
                                   │ Axios + JWT
                    ┌──────────────▼──────────────────────────────┐
                    │              Backend (FastAPI)               │
                    │                                             │
                    │  /api/analyze ──► Wokwi Fetcher             │
                    │       │              │                      │
                    │       ▼              ▼                      │
                    │  Rule Engine ──► AI Analysis (GPT-4o)       │
                    │  (20+ checks)    (circuit + code prompts)   │
                    │       │              │                      │
                    │       └──────┬───────┘                      │
                    │              ▼                               │
                    │  /api/kicad/upload ──► KiCad Parser          │
                    │       │                  │                  │
                    │       ▼                  ▼                  │
                    │  KiCad Rule Engine ── KiCad AI Analysis     │
                    │  (14 ERC + 6 DRC)    (schematic + PCB)     │
                    │                                             │
                    │  Auth (JWT + Google OAuth)                  │
                    │  History (SQLAlchemy + async SQLite)        │
                    └──────────────┬──────────────────────────────┘
                                   │ MCP (stdio)
                    ┌──────────────▼──────────────────────────────┐
                    │         MCP Server (FastMCP)                │
                    │  Tools: analyze_wokwi_project,              │
                    │         analyze_kicad_project,              │
                    │         check_wiring, check_code,           │
                    │         suggest_fix, etc.                   │
                    └─────────────────────────────────────────────┘

项目结构

my_mcp/
├── backend/
│   ├── .env                       # Secrets (JWT key, Google Client ID, OpenAI key)
│   ├── server.py                  # Dual-mode server (FastAPI + MCP)
│   ├── analyzer.py                # Wokwi rule-based + AI analysis engine
│   ├── prompts.py                 # Wokwi OpenAI prompt templates
│   ├── component_knowledge.py     # Board, component, wireless & library specs
│   ├── wokwi_fetch.py             # Wokwi project fetcher
│   ├── kicad_parser.py            # KiCad .kicad_sch/.kicad_pcb file parser
│   ├── kicad_analyzer.py          # KiCad rule-based + AI analysis engine
│   ├── kicad_prompts.py           # KiCad OpenAI prompt templates
│   ├── kicad_component_knowledge.py # KiCad component specs & pin data
│   ├── auth.py                    # JWT + Google token verification
│   ├── auth_routes.py             # Auth API endpoints
│   ├── history_routes.py          # Analysis history endpoints
│   ├── config.py                  # Pydantic settings
│   ├── database.py                # Async SQLAlchemy setup
│   ├── models.py                  # User + AnalysisHistory models
│   └── requirements.txt           # Python dependencies
├── frontend/
│   ├── src/
│   │   ├── auth/                  # AuthContext, LoginPage, ProtectedRoute, UserMenu
│   │   ├── components/
│   │   │   ├── UrlInput.jsx       # Wokwi URL input + design description
│   │   │   ├── KiCadUpload.jsx    # KiCad file drag-and-drop + design description
│   │   │   ├── SummaryBar.jsx     # Fault count summary (errors/warnings/infos)
│   │   │   ├── FaultReport.jsx    # Filterable fault cards with severity badges
│   │   │   ├── CircuitViewer.jsx  # Wokwi circuit parts/connections viewer
│   │   │   ├── SchematicViewer.jsx# KiCad schematic info viewer
│   │   │   ├── CodeView.jsx       # Arduino code with fault annotations
│   │   │   └── FixSuggestion.jsx  # AI-generated fix suggestions
│   │   ├── pages/
│   │   │   ├── ProfilePage.jsx    # User profile + change password
│   │   │   ├── HistoryPage.jsx    # Analysis history with project type badges
│   │   │   └── HistoryDetailPage.jsx # Full report viewer (conditional by type)
│   │   ├── api.js                 # Axios client with JWT interceptors + auto-refresh
│   │   ├── App.jsx                # Dashboard with mode toggle + routing
│   │   └── main.jsx               # Entry point with providers
│   ├── .env                       # VITE_GOOGLE_CLIENT_ID
│   ├── vercel.json                # Vercel SPA routing config
│   └── package.json
├── render.yaml                    # Render deployment config
└── env/                           # Python virtual environment

API终点

公共

认证

Wokwi分析（需要身份验证）

KiCad分析（需要身份验证）

历史记录（需要身份验证）

MCP工具

在MCP模式下运行时(--mode mcp)，服务器通过stdio公开这些工具：

周 ：

• analyze_wokwi_project(wokwi_url) --全面故障分析
• check_wiring(diagram_json) --接线分析
• check_code(sketch_code, diagram_json) --代码分析
• suggest_fix(fault_report, diagram_json, sketch_code) --修复生成

基卡德：

• analyze_kicad_project(schematic_content, pcb_content, project_content) --完整的KiCad分析
• check_kicad_schematic(schematic_content) --ERC分析示意图
• check_kicad_pcb(pcb_content, schematic_content) --PCB DRC分析
• suggest_kicad_fix(fault_report, schematic_content, pcb_content) --修复生成

许可证

麻省理工学院