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

feat: add export_pos tool (kicad-cli, full placement-file option set)

Browse Source 
New MCP tool `export_pos` wrapping `kicad-cli pcb export pos`: exposes
side, format, units, bottom-negate-X, drill-file origin, SMD-only,
exclude-through-hole, exclude-DNP and gerber-board-edge. Rich CLI sibling
of the existing SWIG-limited export_position_file (left untouched).
Self-contained interface handler reading the saved .kicad_pcb.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Gavin Colonese
2026-06-12 10:55:50 -04:00
parent ab7a2101af
commit f6d38f1942
3 changed files with 135 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

54
src/tools/export.ts
View File

@@ -594,5 +594,59 @@ export function registerExportTools(server: McpServer, callKicadScript: CommandF
},
);
// ------------------------------------------------------
// Export Position File Tool (kicad-cli, full option set)
// ------------------------------------------------------
server.tool(
"export_pos",
"Generate a component placement (position / pick-and-place) file via kicad-cli, exposing the full CLI option set (side, format, units, bottom-negate-X, drill-file origin, SMD-only, exclude through-hole / DNP, gerber board edge). Rich CLI sibling of export_position_file. Reads the last SAVED state of the .kicad_pcb.",
{
outputPath: z.string().describe("Output position file path"),
boardPath: z.string().optional().describe("Path to the .kicad_pcb (default: current board)"),
side: z
.enum(["front", "back", "both"])
.optional()
.describe("Board side (gerber format only supports front or back; default both)"),
format: z
.enum(["ascii", "csv", "gerber"])
.optional()
.describe("Output format (default ascii)"),
units: z
.enum(["in", "mm"])
.optional()
.describe("Output units; ascii or csv format only (default in)"),
bottomNegateX: z
.boolean()
.optional()
.describe("Use negative X coordinates for bottom-layer footprints (ascii/csv only)"),
useDrillFileOrigin: z
.boolean()
.optional()
.describe("Use drill/place file origin (ascii/csv only)"),
smdOnly: z.boolean().optional().describe("Include only SMD footprints (ascii/csv only)"),
excludeFpTh: z
.boolean()
.optional()
.describe("Exclude all footprints with through-hole pads (ascii/csv only)"),
excludeDnp: z
.boolean()
.optional()
.describe("Exclude all footprints with the Do Not Populate flag set"),
gerberBoardEdge: z.boolean().optional().describe("Include board edge layer (Gerber only)"),
},
async (args) => {
logger.debug(`Exporting position file to: ${args.outputPath}`);
const result = await callKicadScript("export_pos", args);
return {
content: [
{
type: "text",
text: JSON.stringify(result),
},
],
};
},
);
logger.info("Export tools registered");
}