kicad-mcp-server

nearxos/kicad-mcp-server

Fork 0

Commit Graph

Author	SHA1	Message	Date
KiCAD MCP Bot	04db774a2b	feat: Address multiple open issues (#32 , #30 , #26 , #19 ) Issue #32 - Unknown command errors: - Register get_board_extents in command_routes (was implemented but not registered) - Implement find_component command with pattern matching on reference/value/footprint - Add schemas for both commands Issue #30 - PCB routing replication (Phase 1): - Implement get_component_pads: returns all pads with positions, nets, shapes - Implement get_pad_position: returns specific pad coordinates and properties - Implement query_traces: query traces by net, layer, or bounding box - Add schemas for all new commands Issue #26 - Schematic workflow: - Add missing schemas for add_schematic_connection, add_schematic_net_label, connect_to_net, get_net_connections, and generate_netlist Issue #19 - macOS Python path detection: - Add Python 3.13 to version detection - Add alternative KiCAD installation paths (user Applications, capitalization variants) - Add Homebrew Python fallback paths for Apple Silicon and Intel Macs - Expand platform_helper.py with same improvements Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-01-19 19:17:35 -05:00
KiCAD MCP Bot	d23e90b847	feat: Implement comprehensive MCP capabilities with tool schemas and resources This major update brings the KiCAD MCP server to full MCP 2025-06-18 spec compliance with proper tool schemas and resources capability. ## Dependencies Updated - @modelcontextprotocol/sdk: 1.10.0 → 1.21.0 (critical update) - dotenv: 16.0.3 → 17.0.0 (latest stable) - typescript: 5.2.2 → 5.9.3 - zod: 3.22.2 → 3.25.0 - @types/node: 20.5.6 → 20.19.0 - @types/express: 5.0.1 → 5.0.5 - requests (Python): 2.31.0 → 2.32.5 - Added @cfworker/json-schema for MCP SDK compatibility ## Tool Schemas (52 tools) Created comprehensive JSON Schema definitions for all tools organized by category: - Project Tools (4): create_project, open_project, save_project, get_project_info - Board Tools (9): set_board_size, add_board_outline, add_layer, etc. - Component Tools (10): place_component, move_component, rotate_component, etc. - Routing Tools (8): add_net, route_trace, add_via, route_differential_pair, etc. - Library Tools (4): list_libraries, search_footprints, etc. - Design Rule Tools (4): set_design_rules, run_drc, get_drc_violations, etc. - Export Tools (5): export_gerber, export_pdf, export_svg, export_3d, export_bom - Schematic Tools (6): create_schematic, add_schematic_component, etc. - UI Tools (2): check_kicad_ui, launch_kicad_ui Each tool now has: - Detailed descriptions explaining purpose - Complete JSON Schema for input validation - Required/optional parameter specifications - Type constraints and validation rules ## Resources Capability (8 resources) Implemented MCP resources to expose project state: - `kicad://project/current/info` - Project metadata - `kicad://project/current/board` - Board properties - `kicad://project/current/components` - Component list - `kicad://project/current/nets` - Electrical nets - `kicad://project/current/layers` - Layer stack - `kicad://project/current/design-rules` - Design rules - `kicad://project/current/drc-report` - DRC violations - `kicad://board/preview.png` - Board preview image ## Protocol Compliance - Updated initialize response with proper capabilities declaration - Added `tools: { listChanged: true }` - Added `resources: { subscribe: false, listChanged: true }` - Enhanced serverInfo with title and version - Added instructions field for user guidance - Implemented resources/list method - Implemented resources/read method with proper error handling - All responses follow MCP 2025-06-18 spec exactly ## Benefits ✅ Claude/LLMs can now understand what each tool does ✅ Automatic parameter validation via JSON Schema ✅ Better error messages for invalid inputs ✅ Access to project state via resources (no need to call tools) ✅ Full MCP protocol compliance ✅ Better developer experience with latest SDK features 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-11-05 21:50:33 -05:00

Author

SHA1

Message

Date

KiCAD MCP Bot

04db774a2b

feat: Address multiple open issues (#32 , #30 , #26 , #19 )

Issue #32 - Unknown command errors:
- Register get_board_extents in command_routes (was implemented but not registered)
- Implement find_component command with pattern matching on reference/value/footprint
- Add schemas for both commands

Issue #30 - PCB routing replication (Phase 1):
- Implement get_component_pads: returns all pads with positions, nets, shapes
- Implement get_pad_position: returns specific pad coordinates and properties
- Implement query_traces: query traces by net, layer, or bounding box
- Add schemas for all new commands

Issue #26 - Schematic workflow:
- Add missing schemas for add_schematic_connection, add_schematic_net_label,
  connect_to_net, get_net_connections, and generate_netlist

Issue #19 - macOS Python path detection:
- Add Python 3.13 to version detection
- Add alternative KiCAD installation paths (user Applications, capitalization variants)
- Add Homebrew Python fallback paths for Apple Silicon and Intel Macs
- Expand platform_helper.py with same improvements

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-19 19:17:35 -05:00

KiCAD MCP Bot

d23e90b847

feat: Implement comprehensive MCP capabilities with tool schemas and resources

This major update brings the KiCAD MCP server to full MCP 2025-06-18 spec
compliance with proper tool schemas and resources capability.

## Dependencies Updated
- @modelcontextprotocol/sdk: 1.10.0 → 1.21.0 (critical update)
- dotenv: 16.0.3 → 17.0.0 (latest stable)
- typescript: 5.2.2 → 5.9.3
- zod: 3.22.2 → 3.25.0
- @types/node: 20.5.6 → 20.19.0
- @types/express: 5.0.1 → 5.0.5
- requests (Python): 2.31.0 → 2.32.5
- Added @cfworker/json-schema for MCP SDK compatibility

## Tool Schemas (52 tools)
Created comprehensive JSON Schema definitions for all tools organized by category:
- **Project Tools** (4): create_project, open_project, save_project, get_project_info
- **Board Tools** (9): set_board_size, add_board_outline, add_layer, etc.
- **Component Tools** (10): place_component, move_component, rotate_component, etc.
- **Routing Tools** (8): add_net, route_trace, add_via, route_differential_pair, etc.
- **Library Tools** (4): list_libraries, search_footprints, etc.
- **Design Rule Tools** (4): set_design_rules, run_drc, get_drc_violations, etc.
- **Export Tools** (5): export_gerber, export_pdf, export_svg, export_3d, export_bom
- **Schematic Tools** (6): create_schematic, add_schematic_component, etc.
- **UI Tools** (2): check_kicad_ui, launch_kicad_ui

Each tool now has:
- Detailed descriptions explaining purpose
- Complete JSON Schema for input validation
- Required/optional parameter specifications
- Type constraints and validation rules

## Resources Capability (8 resources)
Implemented MCP resources to expose project state:
- `kicad://project/current/info` - Project metadata
- `kicad://project/current/board` - Board properties
- `kicad://project/current/components` - Component list
- `kicad://project/current/nets` - Electrical nets
- `kicad://project/current/layers` - Layer stack
- `kicad://project/current/design-rules` - Design rules
- `kicad://project/current/drc-report` - DRC violations
- `kicad://board/preview.png` - Board preview image

## Protocol Compliance
- Updated initialize response with proper capabilities declaration
- Added `tools: { listChanged: true }`
- Added `resources: { subscribe: false, listChanged: true }`
- Enhanced serverInfo with title and version
- Added instructions field for user guidance
- Implemented resources/list method
- Implemented resources/read method with proper error handling
- All responses follow MCP 2025-06-18 spec exactly

## Benefits
✅ Claude/LLMs can now understand what each tool does
✅ Automatic parameter validation via JSON Schema
✅ Better error messages for invalid inputs
✅ Access to project state via resources (no need to call tools)
✅ Full MCP protocol compliance
✅ Better developer experience with latest SDK features

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

Co-Authored-By: Claude <noreply@anthropic.com>

2025-11-05 21:50:33 -05:00

2 Commits