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

style: apply Prettier formatting to TS/JS/JSON/MD files

Browse Source 
Add Prettier as a dev dependency with .prettierrc.json config and
.prettierignore. Hook added via mirrors-prettier in pre-commit config.
All TypeScript, JSON, Markdown, and YAML files auto-formatted.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Eugene Mikhantyev
2026-03-29 13:05:50 +01:00
parent c44bd9205d
commit 7d50fa1d4c
82 changed files with 18314 additions and 17317 deletions
Download Patch File Download Diff File Expand all files Collapse all files

603
src/tools/registry.ts
View File

@@ -1,308 +1,295 @@
/**
* Tool Registry for KiCAD MCP Server
*
* Centralizes all tool definitions and provides lookup/search functionality
*/
import { z } from 'zod';
export interface ToolDefinition {
name: string;
description: string;
inputSchema: z.ZodObject<any> | z.ZodType<any>;
// Handler will be registered separately in the existing tool files
}
export interface ToolCategory {
name: string;
description: string;
tools: string[]; // Tool names in this category
}
/**
* Tool category definitions
* Each category groups related tools for better organization
*/
export const toolCategories: ToolCategory[] = [
{
name: "board",
description: "Board configuration: layers, mounting holes, zones, visualization",
tools: [
"add_layer",
"set_active_layer",
"get_layer_list",
"add_mounting_hole",
"add_board_text",
"add_zone",
"get_board_extents",
"get_board_2d_view",
"launch_kicad_ui"
]
},
{
name: "component",
description: "Advanced component operations: edit, delete, search, group, annotate",
tools: [
"rotate_component",
"delete_component",
"edit_component",
"find_component",
"get_component_properties",
"add_component_annotation",
"group_components",
"replace_component"
]
},
{
name: "export",
description: "File export for fabrication and documentation: Gerber, PDF, BOM, 3D models",
tools: [
"export_gerber",
"export_pdf",
"export_svg",
"export_3d",
"export_bom",
"export_netlist",
"export_position_file",
"export_vrml"
]
},
{
name: "drc",
description: "Design rule checking and electrical validation: DRC, net classes, clearances",
tools: [
"set_design_rules",
"get_design_rules",
"run_drc",
"add_net_class",
"assign_net_to_class",
"set_layer_constraints",
"check_clearance",
"get_drc_violations"
]
},
{
name: "schematic",
description: "Schematic operations: create, inspect, add/edit/delete components, wire connections, netlists, annotation",
tools: [
"create_schematic",
"add_schematic_component",
"list_schematic_components",
"move_schematic_component",
"rotate_schematic_component",
"annotate_schematic",
"add_schematic_wire",
"delete_schematic_wire",
"add_schematic_junction",
"add_schematic_net_label",
"delete_schematic_net_label",
"connect_to_net",
"connect_passthrough",
"get_net_connections",
"list_schematic_nets",
"list_schematic_wires",
"list_schematic_labels",
"get_wire_connections",
"generate_netlist",
"sync_schematic_to_board",
"get_schematic_view",
"export_schematic_svg",
"export_schematic_pdf"
]
},
{
name: "library",
description: "Footprint library access: search, browse, get footprint information",
tools: [
"list_libraries",
"search_footprints",
"list_library_footprints",
"get_footprint_info"
]
},
{
name: "routing",
description: "Advanced routing operations: vias, copper pours",
tools: [
"add_via",
"add_copper_pour"
]
},
{
name: "autoroute",
description: "Freerouting autorouter: automatic PCB routing via Specctra DSN/SES",
tools: [
"autoroute",
"export_dsn",
"import_ses",
"check_freerouting"
]
}
];
/**
* Direct tools that are always visible (not routed)
* These are the most frequently used tools
*/
export const directToolNames = [
// Project lifecycle
"create_project",
"open_project",
"save_project",
"snapshot_project",
"get_project_info",
// Core PCB operations
"place_component",
"move_component",
"add_net",
"route_trace",
"get_board_info",
"set_board_size",
// Board setup
"add_board_outline",
// Schematic essentials (always visible so AI uses them correctly)
"add_schematic_component",
"list_schematic_components",
"annotate_schematic",
"connect_passthrough",
"connect_to_net",
"add_schematic_net_label",
// Schematic <-> PCB sync (F8 equivalent)
"sync_schematic_to_board",
// UI management
"check_kicad_ui"
];
// Build lookup maps at module load time
const categoryMap = new Map<string, ToolCategory>();
const toolCategoryMap = new Map<string, string>();
export function initializeRegistry() {
// Build category map
for (const category of toolCategories) {
categoryMap.set(category.name, category);
// Build tool -> category map
for (const toolName of category.tools) {
toolCategoryMap.set(toolName, category.name);
}
}
}
/**
* Get a category by name
*/
export function getCategory(name: string): ToolCategory | undefined {
return categoryMap.get(name);
}
/**
* Get the category name for a tool
*/
export function getToolCategory(toolName: string): string | undefined {
return toolCategoryMap.get(toolName);
}
/**
* Get all categories
*/
export function getAllCategories(): ToolCategory[] {
return toolCategories;
}
/**
* Get all routed tool names (excludes direct tools)
*/
export function getRoutedToolNames(): string[] {
const allRoutedTools: string[] = [];
for (const category of toolCategories) {
allRoutedTools.push(...category.tools);
}
return allRoutedTools;
}
/**
* Check if a tool is a direct tool
*/
export function isDirectTool(toolName: string): boolean {
return directToolNames.includes(toolName);
}
/**
* Check if a tool is a routed tool
*/
export function isRoutedTool(toolName: string): boolean {
return toolCategoryMap.has(toolName);
}
/**
* Search for tools by keyword
* Searches tool names, descriptions, and category names
*/
export interface SearchResult {
category: string;
tool: string;
description: string;
}
export function searchTools(query: string): SearchResult[] {
const q = query.toLowerCase();
const matches: SearchResult[] = [];
// Search direct tools first
for (const toolName of directToolNames) {
if (toolName.toLowerCase().includes(q)) {
matches.push({
category: "direct",
tool: toolName,
description: `${toolName} (direct tool — call directly, no execute_tool needed)`
});
}
}
// Search routed tools by name and category
for (const category of toolCategories) {
const categoryMatch =
category.name.toLowerCase().includes(q) ||
category.description.toLowerCase().includes(q);
for (const toolName of category.tools) {
if (toolName.toLowerCase().includes(q) || categoryMatch) {
matches.push({
category: category.name,
tool: toolName,
description: `${toolName} (${category.name})`
});
}
}
}
return matches.slice(0, 20); // Limit results
}
/**
* Get statistics about the tool registry
*/
export function getRegistryStats() {
const routedToolCount = getRoutedToolNames().length;
const directToolCount = directToolNames.length;
return {
total_categories: toolCategories.length,
total_routed_tools: routedToolCount,
total_direct_tools: directToolCount,
total_tools: routedToolCount + directToolCount,
categories: toolCategories.map(c => ({
name: c.name,
tool_count: c.tools.length
}))
};
}
// Initialize on module load
initializeRegistry();
/**
* Tool Registry for KiCAD MCP Server
*
* Centralizes all tool definitions and provides lookup/search functionality
*/
import { z } from "zod";
export interface ToolDefinition {
name: string;
description: string;
inputSchema: z.ZodObject<any> | z.ZodType<any>;
// Handler will be registered separately in the existing tool files
}
export interface ToolCategory {
name: string;
description: string;
tools: string[]; // Tool names in this category
}
/**
* Tool category definitions
* Each category groups related tools for better organization
*/
export const toolCategories: ToolCategory[] = [
{
name: "board",
description: "Board configuration: layers, mounting holes, zones, visualization",
tools: [
"add_layer",
"set_active_layer",
"get_layer_list",
"add_mounting_hole",
"add_board_text",
"add_zone",
"get_board_extents",
"get_board_2d_view",
"launch_kicad_ui",
],
},
{
name: "component",
description: "Advanced component operations: edit, delete, search, group, annotate",
tools: [
"rotate_component",
"delete_component",
"edit_component",
"find_component",
"get_component_properties",
"add_component_annotation",
"group_components",
"replace_component",
],
},
{
name: "export",
description: "File export for fabrication and documentation: Gerber, PDF, BOM, 3D models",
tools: [
"export_gerber",
"export_pdf",
"export_svg",
"export_3d",
"export_bom",
"export_netlist",
"export_position_file",
"export_vrml",
],
},
{
name: "drc",
description: "Design rule checking and electrical validation: DRC, net classes, clearances",
tools: [
"set_design_rules",
"get_design_rules",
"run_drc",
"add_net_class",
"assign_net_to_class",
"set_layer_constraints",
"check_clearance",
"get_drc_violations",
],
},
{
name: "schematic",
description:
"Schematic operations: create, inspect, add/edit/delete components, wire connections, netlists, annotation",
tools: [
"create_schematic",
"add_schematic_component",
"list_schematic_components",
"move_schematic_component",
"rotate_schematic_component",
"annotate_schematic",
"add_schematic_wire",
"delete_schematic_wire",
"add_schematic_junction",
"add_schematic_net_label",
"delete_schematic_net_label",
"connect_to_net",
"connect_passthrough",
"get_net_connections",
"list_schematic_nets",
"list_schematic_wires",
"list_schematic_labels",
"get_wire_connections",
"generate_netlist",
"sync_schematic_to_board",
"get_schematic_view",
"export_schematic_svg",
"export_schematic_pdf",
],
},
{
name: "library",
description: "Footprint library access: search, browse, get footprint information",
tools: ["list_libraries", "search_footprints", "list_library_footprints", "get_footprint_info"],
},
{
name: "routing",
description: "Advanced routing operations: vias, copper pours",
tools: ["add_via", "add_copper_pour"],
},
{
name: "autoroute",
description: "Freerouting autorouter: automatic PCB routing via Specctra DSN/SES",
tools: ["autoroute", "export_dsn", "import_ses", "check_freerouting"],
},
];
/**
* Direct tools that are always visible (not routed)
* These are the most frequently used tools
*/
export const directToolNames = [
// Project lifecycle
"create_project",
"open_project",
"save_project",
"snapshot_project",
"get_project_info",
// Core PCB operations
"place_component",
"move_component",
"add_net",
"route_trace",
"get_board_info",
"set_board_size",
// Board setup
"add_board_outline",
// Schematic essentials (always visible so AI uses them correctly)
"add_schematic_component",
"list_schematic_components",
"annotate_schematic",
"connect_passthrough",
"connect_to_net",
"add_schematic_net_label",
// Schematic <-> PCB sync (F8 equivalent)
"sync_schematic_to_board",
// UI management
"check_kicad_ui",
];
// Build lookup maps at module load time
const categoryMap = new Map<string, ToolCategory>();
const toolCategoryMap = new Map<string, string>();
export function initializeRegistry() {
// Build category map
for (const category of toolCategories) {
categoryMap.set(category.name, category);
// Build tool -> category map
for (const toolName of category.tools) {
toolCategoryMap.set(toolName, category.name);
}
}
}
/**
* Get a category by name
*/
export function getCategory(name: string): ToolCategory | undefined {
return categoryMap.get(name);
}
/**
* Get the category name for a tool
*/
export function getToolCategory(toolName: string): string | undefined {
return toolCategoryMap.get(toolName);
}
/**
* Get all categories
*/
export function getAllCategories(): ToolCategory[] {
return toolCategories;
}
/**
* Get all routed tool names (excludes direct tools)
*/
export function getRoutedToolNames(): string[] {
const allRoutedTools: string[] = [];
for (const category of toolCategories) {
allRoutedTools.push(...category.tools);
}
return allRoutedTools;
}
/**
* Check if a tool is a direct tool
*/
export function isDirectTool(toolName: string): boolean {
return directToolNames.includes(toolName);
}
/**
* Check if a tool is a routed tool
*/
export function isRoutedTool(toolName: string): boolean {
return toolCategoryMap.has(toolName);
}
/**
* Search for tools by keyword
* Searches tool names, descriptions, and category names
*/
export interface SearchResult {
category: string;
tool: string;
description: string;
}
export function searchTools(query: string): SearchResult[] {
const q = query.toLowerCase();
const matches: SearchResult[] = [];
// Search direct tools first
for (const toolName of directToolNames) {
if (toolName.toLowerCase().includes(q)) {
matches.push({
category: "direct",
tool: toolName,
description: `${toolName} (direct tool — call directly, no execute_tool needed)`,
});
}
}
// Search routed tools by name and category
for (const category of toolCategories) {
const categoryMatch =
category.name.toLowerCase().includes(q) || category.description.toLowerCase().includes(q);
for (const toolName of category.tools) {
if (toolName.toLowerCase().includes(q) || categoryMatch) {
matches.push({
category: category.name,
tool: toolName,
description: `${toolName} (${category.name})`,
});
}
}
}
return matches.slice(0, 20); // Limit results
}
/**
* Get statistics about the tool registry
*/
export function getRegistryStats() {
const routedToolCount = getRoutedToolNames().length;
const directToolCount = directToolNames.length;
return {
total_categories: toolCategories.length,
total_routed_tools: routedToolCount,
total_direct_tools: directToolCount,
total_tools: routedToolCount + directToolCount,
categories: toolCategories.map((c) => ({
name: c.name,
tool_count: c.tools.length,
})),
};
}
// Initialize on module load
initializeRegistry();