nearxos/kicad-mcp-server
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: comprehensive documentation overhaul for v2.2.3

Browse Source 
Major documentation update bringing all docs current with the 122-tool,
16-category state of the project (previously frozen at v2.1.0-alpha/59 tools).

New documentation (9 files):
- FREEROUTING_GUIDE.md - autorouter setup, Docker/Podman, all 4 tools
- SCHEMATIC_TOOLS_REFERENCE.md - all 27 schematic tools with parameters
- ROUTING_TOOLS_REFERENCE.md - all 13 routing tools with examples
- FOOTPRINT_SYMBOL_CREATOR_GUIDE.md - 8 creator tools with examples
- SVG_IMPORT_GUIDE.md - SVG logo import tool
- DATASHEET_TOOLS_GUIDE.md - datasheet enrichment tools
- PCB_DESIGN_WORKFLOW.md - end-to-end design guide
- ARCHITECTURE.md - system architecture for contributors
- INDEX.md - documentation table of contents

Updated documentation (12 files):
- README.md - tool count 64->122, feature list, contributor credits
- TOOL_INVENTORY.md - complete rebuild with all 122 tools
- STATUS_SUMMARY.md - updated to v2.2.3 feature matrix
- ROADMAP.md - marked completed milestones, added v2.3+ vision
- KNOWN_ISSUES.md - removed resolved issues, added v2.2.x fixes
- CLIENT_CONFIGURATION.md - added KICAD_MCP_DEV, FREEROUTING_JAR env vars
- LIBRARY_INTEGRATION.md - added symbol and project-local library support
- ROUTER_ARCHITECTURE.md, ROUTER_QUICK_START.md - updated tool counts
- IPC_BACKEND_STATUS.md - updated dates
- JLCPCB_USAGE_GUIDE.md - added cross-reference note
- CONTRIBUTING.md - added ARCHITECTURE.md reference, updated tool count

Archived 10 completed planning docs to docs/archive/.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
KiCAD MCP Bot
2026-03-21 01:31:44 -04:00
parent e5179e5fab
commit f047a4e4d1
32 changed files with 3421 additions and 1070 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
docs/ROUTER_QUICK_START.md
View File

@@ -2,7 +2,7 @@
## What is the Router?
The KiCAD MCP Server now includes an intelligent tool router that organizes 59 tools into 7 discoverable categories. This reduces AI context usage by up to 70% while maintaining full access to all functionality.
The KiCAD MCP Server includes an intelligent tool router that organizes 122+ tools into 8 discoverable categories. This reduces AI context usage by up to 70% while maintaining full access to all functionality.
## How It Works
@@ -20,7 +20,7 @@ When you ask Claude to do something (like "export gerber files"), it will:
## Tool Categories
The 47 routed tools are organized into these categories:
The 110+ routed tools are organized into these categories:
### 1. board (9 tools)
Board configuration: layers, mounting holes, zones, visualization
@@ -154,15 +154,12 @@ For implementation details, see:
## Token Savings
**Before Router:**
- 59 tools × ~700 tokens each = ~42K tokens per conversation
- 122 tools × ~700 tokens each = ~85K tokens per conversation
**After Router (Current - Phase 1):**
**After Router (Current):**
- 12 direct tools + 4 router tools = 16 tools visible
- Still ~42K tokens (all tools still registered for backwards compatibility)
- Routed tools discovered on-demand
- ~12-15K tokens per conversation
- **~80% reduction** in context usage
**After Phase 2 (Optional Optimization):**
- Only 16 tools visible to Claude
- ~12K tokens per conversation
- **70% reduction** in context usage
Phase 1 is complete and functional. Phase 2 (hiding routed tools) is optional and can be implemented when desired.
The router pattern is complete and functional, providing efficient tool discovery while maintaining full access to all 122+ tools.