@jlcpcb/mcp 0.1.0

package/src/index.ts

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+
+/**
+ * jlc-mcp
+ * MCP server for JLC/EasyEDA component sourcing and library conversion
+ *
+ * This server uses LCSC part numbers (e.g., C2040) because LCSC is JLC PCB's
+ * preferred component supplier for PCB assembly (PCBA). Components sourced via
+ * LCSC are guaranteed to be available for JLC's assembly service.
+ *
+ * EasyEDA (owned by JLC/LCSC) provides the symbol and footprint data.
+ */
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+
+import { tools, toolHandlers } from './tools/index.js';
+import { createLogger, ensureGlobalLibraryTables } from '@jlcpcb/core';
+import { startHttpServer } from './http/server.js';
+
+const logger = createLogger('jlc-mcp');
+
+// Create MCP server
+const server = new Server(
+  {
+    name: 'jlc-mcp',
+    version: '0.1.0',
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+// Handle list tools request
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  logger.debug('Listing tools');
+  return { tools };
+});
+
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  logger.debug(`Tool call: ${name}`, args);
+
+  const handler = toolHandlers[name];
+
+  if (!handler) {
+    return {
+      content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+      isError: true,
+    };
+  }
+
+  try {
+    return await handler(args);
+  } catch (error) {
+    logger.error(`Tool error: ${name}`, error);
+    return {
+      content: [{
+        type: 'text',
+        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+      }],
+      isError: true,
+    };
+  }
+});
+
+// Run the server
+async function main() {
+  // Register JLC libraries in KiCad global tables
+  const registration = await ensureGlobalLibraryTables();
+
+  if (!registration.success) {
+    logger.error('Failed to register JLC libraries in KiCad global tables', {
+      errors: registration.errors,
+    });
+    process.exit(1);
+  }
+
+  // Log registration summary
+  const { symLibTable, fpLibTable, libraryStubs, version } = registration;
+  if (symLibTable.created || symLibTable.modified || fpLibTable.created || fpLibTable.modified) {
+    logger.info(`JLC libraries registered in KiCad ${version}`, {
+      symLibTable: symLibTable.created
+        ? `created with ${symLibTable.entriesAdded} entries`
+        : symLibTable.modified
+          ? `added ${symLibTable.entriesAdded} entries`
+          : 'already configured',
+      fpLibTable: fpLibTable.created
+        ? 'created'
+        : fpLibTable.modified
+          ? 'updated'
+          : 'already configured',
+      stubsCreated: libraryStubs.symbolsCreated.length + libraryStubs.directoriesCreated.length,
+    });
+  }
+
+  // Start HTTP server for the component browser UI
+  const httpPort = startHttpServer();
+  logger.info(`Component browser available at http://localhost:${httpPort}`);
+
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  logger.info('JLC MCP server running on stdio');
+}
+
+main().catch((error) => {
+  logger.error('Server error', error);
+  process.exit(1);
+});

package/src/tools/details.ts

@@ -0,0 +1,66 @@
+/**
+ * Component details tools for MCP
+ */
+
+import { z } from 'zod';
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { easyedaClient } from '@jlcpcb/core';
+
+export const getComponentTool: Tool = {
+  name: 'component_get',
+  description: 'Get detailed component information by LCSC part number (e.g., C2040). LCSC is JLC PCB\'s preferred supplier - components with LCSC IDs are available for JLC assembly. Returns symbol pins, footprint pads, manufacturer info, datasheet URL, and 3D model reference.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      lcsc_id: {
+        type: 'string',
+        description: 'LCSC part number (e.g., C2040, C14663)',
+      },
+    },
+    required: ['lcsc_id'],
+  },
+};
+
+export const GetComponentParamsSchema = z.object({
+  lcsc_id: z.string().regex(/^C\d+$/, 'Invalid LCSC part number'),
+});
+
+export async function handleGetComponent(args: unknown) {
+  const params = GetComponentParamsSchema.parse(args);
+
+  const component = await easyedaClient.getComponentData(params.lcsc_id);
+
+  if (!component) {
+    return {
+      content: [{
+        type: 'text' as const,
+        text: `Component ${params.lcsc_id} not found`,
+      }],
+      isError: true,
+    };
+  }
+
+  // Return a clean summary
+  const summary = {
+    info: component.info,
+    symbol: {
+      pin_count: component.symbol.pins.length,
+      pins: component.symbol.pins,
+    },
+    footprint: {
+      name: component.footprint.name,
+      type: component.footprint.type,
+      pad_count: component.footprint.pads.length,
+      pads: component.footprint.pads,
+    },
+    has_3d_model: !!component.model3d,
+    model_3d_uuid: component.model3d?.uuid,
+  };
+
+  return {
+    content: [{
+      type: 'text' as const,
+      text: JSON.stringify(summary, null, 2),
+    }],
+  };
+}