Add comprehensive Windows support and documentation

Windows Support Package:
- PowerShell automated setup script (setup-windows.ps1)
  - Auto-detects KiCAD installation and version
  - Validates all prerequisites (Node.js, Python, pcbnew)
  - Installs dependencies automatically
  - Generates MCP configuration with platform-specific paths
  - Runs comprehensive diagnostic tests
- Windows troubleshooting guide (docs/WINDOWS_TROUBLESHOOTING.md)
- Platform comparison guide (docs/PLATFORM_GUIDE.md)

Code Enhancements:
- Enhanced Windows error diagnostics in Python interface
- Startup validation in TypeScript server
- Platform-specific error messages with troubleshooting hints
- Component library integration (153 KiCAD footprint libraries)
- Routing operations KiCAD 9.0 API compatibility fixes

Documentation Updates:
- Updated README with Windows automated setup
- Real-time collaboration workflow guide
- Library integration documentation
- JLCPCB integration planning
- Updated status to reflect Windows support
- Changelogs for Nov 1 and Nov 5 updates

Infrastructure:
- Added venv/ to .gitignore to prevent virtual env commits

Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
KiCAD MCP Bot
2025-11-05 09:10:45 -05:00
parent 0354b70c68
commit 5717a91a59
18 changed files with 4551 additions and 328 deletions

View File

@@ -2,60 +2,78 @@
**Vision:** Enable anyone to design professional PCBs through natural conversation with AI
**Current Version:** 2.0.0-alpha.2
**Current Version:** 2.1.0-alpha
**Target:** 2.0.0 stable by end of Week 12
---
## 🎯 Week 2: Component Integration & Routing
## Week 2: Component Integration & Routing
**Goal:** Make the MCP server useful for real PCB design
**Status:** 80% Complete (2025-11-01)
### High Priority
**1. Component Library Integration** 🔴
- [ ] Detect KiCAD footprint library paths
- [ ] Add configuration for custom library paths
- [ ] Create footprint search/autocomplete
- [ ] Test component placement end-to-end
- [ ] Document supported footprints
**1. Component Library Integration** **COMPLETE**
- [x] Detect KiCAD footprint library paths
- [x] Add configuration for custom library paths
- [x] Create footprint search/autocomplete
- [x] Test component placement end-to-end
- [x] Document supported footprints
**Deliverable:** Place components with actual footprints from libraries
**Deliverable:** Place components with actual footprints from libraries (153 libraries discovered!)
**2. Routing Operations** 🟡
- [ ] Test `route_trace` with KiCAD 9.0
- [ ] Test `add_via` with KiCAD 9.0
- [ ] Test `add_copper_pour` with KiCAD 9.0
- [ ] Fix any API compatibility issues
- [ ] Add routing examples to docs
**2. Routing Operations** **COMPLETE**
- [x] Test `route_trace` with KiCAD 9.0
- [x] Test `add_via` with KiCAD 9.0
- [x] Test `add_copper_pour` with KiCAD 9.0
- [x] Fix any API compatibility issues
- [x] Add routing examples to docs
**Deliverable:** Successfully route a simple board (LED + resistor)
**Deliverable:** Successfully route a simple board (tested with nets, traces, vias, copper pours)
**3. JLCPCB Parts Database** 🟡
- [ ] Download/parse JLCPCB parts CSV
**3. JLCPCB Parts Database** 📋 **PLANNED**
- [x] Research JLCPCB API and data format
- [x] Design integration architecture
- [ ] Download/parse JLCPCB parts database (~108k parts)
- [ ] Map parts to KiCAD footprints
- [ ] Create search by part number
- [ ] Add price/stock information
- [ ] Integrate with component placement
**Deliverable:** "Add a 10k resistor (JLCPCB basic part)"
**Deliverable:** "Add a 10k resistor (JLCPCB basic part)" - Ready to implement
### Medium Priority
**4. Fix get_board_info** 🟢
**4. Fix get_board_info** 🟡 **DEFERRED**
- [ ] Update layer constants for KiCAD 9.0
- [ ] Add backward compatibility
- [ ] Test with real boards
**Status:** Low priority, workarounds available
**5. Example Projects** 🟢
- [ ] LED blinker (555 timer)
- [ ] Arduino Uno shield template
- [ ] Raspberry Pi HAT template
- [ ] Video tutorial of complete workflow
### Bonus Achievements ✨
**Real-time Collaboration****COMPLETE**
- [x] Test MCP→UI workflow (AI places, human sees)
- [x] Test UI→MCP workflow (human edits, AI reads)
- [x] Document best practices and limitations
- [x] Verify bidirectional sync works correctly
**Documentation****COMPLETE**
- [x] LIBRARY_INTEGRATION.md (comprehensive library guide)
- [x] REALTIME_WORKFLOW.md (collaboration workflows)
- [x] JLCPCB_INTEGRATION_PLAN.md (implementation plan)
---
## 🚀 Week 3: IPC Backend & Real-time Updates
## Week 3: IPC Backend & Real-time Updates
**Goal:** Eliminate manual reload - see changes instantly
@@ -91,7 +109,7 @@
---
## 📦 Week 4-5: Smart BOM & Supplier Integration
## Week 4-5: Smart BOM & Supplier Integration
**Goal:** Optimize component selection for cost and availability
@@ -116,7 +134,7 @@
---
## 🎨 Week 6-7: Design Patterns & Templates
## Week 6-7: Design Patterns & Templates
**Goal:** Accelerate common design tasks
@@ -143,7 +161,7 @@
---
## 🎓 Week 8-9: Guided Workflows & Education
## Week 8-9: Guided Workflows & Education
**Goal:** Make PCB design accessible to beginners
@@ -169,7 +187,7 @@
---
## 🔬 Week 10-11: Advanced Features
## Week 10-11: Advanced Features
**Goal:** Support complex professional designs
@@ -191,7 +209,7 @@
---
## 🎉 Week 12: Polish & Release
## Week 12: Polish & Release
**Goal:** Production-ready v2.0 release
@@ -221,7 +239,7 @@
---
## 🌟 Future (Post-v2.0)
## Future (Post-v2.0)
**Big Ideas for v3.0+**
@@ -257,7 +275,7 @@
---
## 📊 Success Metrics
## Success Metrics
**v2.0 Release Criteria:**
@@ -276,7 +294,7 @@
---
## 🤝 How to Contribute
## How to Contribute
See the roadmap and want to help?