@jlcpcb/mcp 0.2.0 → 0.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jlcpcb/mcp",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "private": false,
   "type": "module",
   "description": "MCP server for JLC/EasyEDA component sourcing, library fetching, and conversion to KiCad format",
@@ -21,6 +21,7 @@
     "build": "bun build ./src/index.ts --outdir ./dist --target node",
     "start": "bun run ./src/index.ts",
     "dev": "bun --watch ./src/index.ts",
+    "lint": "eslint src --ext .ts",
     "typecheck": "tsc --noEmit",
     "test": "bun test",
     "clean": "rm -rf dist"

package/src/index.ts

@@ -11,6 +11,7 @@
  * EasyEDA (owned by JLC/LCSC) provides the symbol and footprint data.
  */
 
+import { createRequire } from 'module';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import {
@@ -21,13 +22,16 @@ import {
 import { tools, toolHandlers } from './tools/index.js';
 import { createLogger, ensureGlobalLibraryTables, startHttpServer } from '@jlcpcb/core';
 
+const require = createRequire(import.meta.url);
+const { version } = require('../package.json');
+
 const logger = createLogger('jlc-mcp');
 
 // Create MCP server
 const server = new Server(
   {
     name: 'jlc-mcp',
-    version: '0.1.0',
+    version,
   },
   {
     capabilities: {

package/src/schemas.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared validation schemas for MCP tools
+ * Re-exports from @jlcpcb/core for consistency across packages
+ */
+
+export {
+  LCSCPartNumberSchema,
+  LCSCPartNumberSchema as LcscIdSchema, // Alias for backwards compatibility
+  EasyEDAUuidSchema,
+  ComponentIdSchema,
+  SafePathSchema,
+  isLcscId,
+  isEasyEDAUuid,
+} from '@jlcpcb/core';

package/src/services.ts

@@ -0,0 +1,34 @@
+/**
+ * Shared service instances for MCP tools
+ * Provides singleton access to core services to avoid multiple instantiations
+ */
+
+import {
+  createComponentService,
+  createLibraryService,
+  type ComponentService,
+  type LibraryService,
+} from '@jlcpcb/core';
+
+let componentService: ComponentService | null = null;
+let libraryService: LibraryService | null = null;
+
+/**
+ * Get the shared ComponentService instance
+ */
+export function getComponentService(): ComponentService {
+  if (!componentService) {
+    componentService = createComponentService();
+  }
+  return componentService;
+}
+
+/**
+ * Get the shared LibraryService instance
+ */
+export function getLibraryService(): LibraryService {
+  if (!libraryService) {
+    libraryService = createLibraryService();
+  }
+  return libraryService;
+}

package/src/tools/batch.ts

@@ -0,0 +1,123 @@
+/**
+ * Batch operations for MCP
+ * Install multiple components in a single call
+ */
+
+import { z } from 'zod';
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { getLibraryService } from '../services.js';
+import { LcscIdSchema } from '../schemas.js';
+
+export const libraryBatchInstallTool: Tool = {
+  name: 'library_batch_install',
+  description: `Install multiple components to KiCad libraries in a single call.
+
+Accepts up to 10 LCSC part numbers. Components are installed in parallel.
+Returns a summary of installed, skipped (already installed), and failed components.
+
+Use this when you need to install a bill of materials or multiple components at once.`,
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ids: {
+        type: 'array',
+        items: { type: 'string' },
+        maxItems: 10,
+        description: 'Array of LCSC part numbers (e.g., ["C2040", "C5446", "C14663"])',
+      },
+      force: {
+        type: 'boolean',
+        description: 'Reinstall even if already exists (default: false)',
+      },
+      include_3d: {
+        type: 'boolean',
+        description: 'Include 3D models if available (default: false)',
+      },
+    },
+    required: ['ids'],
+  },
+};
+
+export const BatchInstallParamsSchema = z.object({
+  ids: z.array(LcscIdSchema).min(1).max(10),
+  force: z.boolean().optional(),
+  include_3d: z.boolean().optional(),
+});
+
+interface BatchResult {
+  id: string;
+  status: 'installed' | 'skipped' | 'failed';
+  symbol_ref?: string;
+  footprint_ref?: string;
+  reason?: string;
+  error?: string;
+}
+
+export async function handleLibraryBatchInstall(args: unknown) {
+  const params = BatchInstallParamsSchema.parse(args);
+
+  const results: BatchResult[] = [];
+  let installed = 0;
+  let skipped = 0;
+  let failed = 0;
+
+  // Install components in parallel (max 10)
+  const installPromises = params.ids.map(async (id): Promise<BatchResult> => {
+    try {
+      const result = await getLibraryService().install(id, {
+        include3d: params.include_3d,
+        force: params.force,
+      });
+
+      // Check if it was actually installed or already existed
+      if (result.symbolAction === 'exists') {
+        return {
+          id,
+          status: 'skipped',
+          symbol_ref: result.symbolRef,
+          footprint_ref: result.footprintRef,
+          reason: 'already installed',
+        };
+      }
+
+      return {
+        id,
+        status: 'installed',
+        symbol_ref: result.symbolRef,
+        footprint_ref: result.footprintRef,
+      };
+    } catch (error) {
+      return {
+        id,
+        status: 'failed',
+        error: error instanceof Error ? error.message : 'Unknown error',
+      };
+    }
+  });
+
+  const installResults = await Promise.all(installPromises);
+
+  // Aggregate results
+  for (const result of installResults) {
+    results.push(result);
+    if (result.status === 'installed') installed++;
+    else if (result.status === 'skipped') skipped++;
+    else failed++;
+  }
+
+  return {
+    content: [{
+      type: 'text' as const,
+      text: JSON.stringify({
+        success: failed < params.ids.length, // At least one succeeded
+        summary: {
+          total: params.ids.length,
+          installed,
+          skipped,
+          failed,
+        },
+        results,
+      }),
+    }],
+  };
+}

package/src/tools/index.test.ts

@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'bun:test';
+
+import { toolHandlers, tools } from './index.js';
+
+describe('tools', () => {
+  it('exposes a handler for every registered tool', () => {
+    expect(tools.length).toBeGreaterThan(0);
+
+    for (const tool of tools) {
+      expect(toolHandlers[tool.name]).toBeDefined();
+    }
+  });
+});

package/src/tools/index.ts

@@ -1,22 +1,22 @@
 /**
- * MCP tool definitions and handlers for LCSC MCP server
+ * MCP tool definitions and handlers for JLC-MCP server
+ * Streamlined version with 6 consolidated tools
  */
 
 import type { Tool } from '@modelcontextprotocol/sdk/types.js';
 
-// Import LCSC tools
-import { searchComponentsTool, handleSearchComponents } from './search.js';
-import { getComponentTool, handleGetComponent } from './details.js';
+// Import tools
+import { componentSearchTool, handleComponentSearch } from './search.js';
 import {
-  getSymbolKicadTool,
-  getFootprintKicadTool,
-  fetchLibraryTool,
-  get3DModelTool,
-  handleGetSymbolKicad,
-  handleGetFootprintKicad,
-  handleFetchLibrary,
-  handleGet3DModel,
+  libraryInstallTool,
+  libraryGetComponentTool,
+  handleLibraryInstall,
+  handleLibraryGetComponent,
 } from './library.js';
+import {
+  libraryBatchInstallTool,
+  handleLibraryBatchInstall,
+} from './batch.js';
 import {
   updateLibraryTool,
   handleUpdateLibrary,
@@ -26,62 +26,41 @@ import {
   handleFixLibrary,
 } from './library-fix.js';
 
-// Import EasyEDA community tools
-import {
-  easyedaSearchTool,
-  easyedaGet3DModelTool,
-  handleEasyedaSearch,
-  handleEasyedaGet3DModel,
-} from './easyeda.js';
-
-// Export all tool definitions
+// Export all tool definitions (6 tools total)
 export const tools: Tool[] = [
-  // LCSC/JLCPCB official library
-  searchComponentsTool,
-  getComponentTool,
-  getSymbolKicadTool,
-  getFootprintKicadTool,
-  fetchLibraryTool,
-  updateLibraryTool,
-  fixLibraryTool,
-  get3DModelTool,
-  // EasyEDA community library
-  easyedaSearchTool,
-  easyedaGet3DModelTool,
+  componentSearchTool,       // Search LCSC or EasyEDA community
+  libraryInstallTool,        // Install single component
+  libraryBatchInstallTool,   // Install up to 10 components
+  libraryGetComponentTool,   // Get installed component metadata
+  updateLibraryTool,         // Regenerate all components
+  fixLibraryTool,            // Apply pin corrections
 ];
 
-// Tool handler map
+// Tool handler map - derived from tool definitions to prevent name mismatches
 export const toolHandlers: Record<string, (args: unknown) => Promise<{
   content: Array<{ type: 'text'; text: string }>;
   isError?: boolean;
 }>> = {
-  // LCSC/JLCPCB official library
-  component_search: handleSearchComponents,
-  component_get: handleGetComponent,
-  library_get_symbol: handleGetSymbolKicad,
-  library_get_footprint: handleGetFootprintKicad,
-  library_fetch: handleFetchLibrary,
-  library_update: handleUpdateLibrary,
-  library_fix: handleFixLibrary,
-  library_get_3d_model: handleGet3DModel,
-  // EasyEDA community library
-  easyeda_search: handleEasyedaSearch,
-  easyeda_get_3d_model: handleEasyedaGet3DModel,
+  [componentSearchTool.name]: handleComponentSearch,
+  [libraryInstallTool.name]: handleLibraryInstall,
+  [libraryBatchInstallTool.name]: handleLibraryBatchInstall,
+  [libraryGetComponentTool.name]: handleLibraryGetComponent,
+  [updateLibraryTool.name]: handleUpdateLibrary,
+  [fixLibraryTool.name]: handleFixLibrary,
 };
 
-// Re-export individual tools
-export { searchComponentsTool, handleSearchComponents } from './search.js';
-export { getComponentTool, handleGetComponent } from './details.js';
+// Re-export for direct imports
+export { componentSearchTool, handleComponentSearch } from './search.js';
 export {
-  getSymbolKicadTool,
-  getFootprintKicadTool,
-  fetchLibraryTool,
-  get3DModelTool,
-  handleGetSymbolKicad,
-  handleGetFootprintKicad,
-  handleFetchLibrary,
-  handleGet3DModel,
+  libraryInstallTool,
+  libraryGetComponentTool,
+  handleLibraryInstall,
+  handleLibraryGetComponent,
 } from './library.js';
+export {
+  libraryBatchInstallTool,
+  handleLibraryBatchInstall,
+} from './batch.js';
 export {
   updateLibraryTool,
   handleUpdateLibrary,
@@ -90,9 +69,3 @@ export {
   fixLibraryTool,
   handleFixLibrary,
 } from './library-fix.js';
-export {
-  easyedaSearchTool,
-  easyedaGet3DModelTool,
-  handleEasyedaSearch,
-  handleEasyedaGet3DModel,
-} from './easyeda.js';

package/src/tools/library-fix.ts

@@ -19,28 +19,11 @@ import {
   getFootprintReference as getCategoryFootprintRef,
   ensureDir,
   writeText,
+  detectKicadVersion,
   type EasyEDAPin,
 } from '@jlcpcb/core';
 import { join } from 'path';
 
-// KiCad versions to check (newest first)
-const KICAD_VERSIONS = ['9.0', '8.0'];
-
-/**
- * Detect KiCad major version from existing user directories
- */
-function detectKicadVersion(): string {
-  const home = homedir();
-  const baseDir = join(home, 'Documents', 'KiCad');
-
-  for (const version of KICAD_VERSIONS) {
-    if (existsSync(join(baseDir, version))) {
-      return version;
-    }
-  }
-  return '9.0'; // Default
-}
-
 /**
  * Get library paths for fix operation
  */

package/src/tools/library-update.ts

@@ -21,30 +21,13 @@ import {
   type LibraryCategory,
   ensureDir,
   writeText,
+  detectKicadVersion,
 } from '@jlcpcb/core';
 import { join } from 'path';
 
-// KiCad versions to check (newest first)
-const KICAD_VERSIONS = ['9.0', '8.0'];
-
 // 3rd party library namespace
 const LIBRARY_NAMESPACE = 'jlc_mcp';
 
-/**
- * Detect KiCad major version from existing user directories
- */
-function detectKicadVersion(): string {
-  const home = homedir();
-  const baseDir = join(home, 'Documents', 'KiCad');
-
-  for (const version of KICAD_VERSIONS) {
-    if (existsSync(join(baseDir, version))) {
-      return version;
-    }
-  }
-  return '9.0'; // Default
-}
-
 /**
  * Get library paths for update operation
  * Platform-specific paths matching where ${KICAD9_3RD_PARTY} resolves:
@@ -383,6 +366,8 @@ export async function handleUpdateLibrary(args: unknown) {
     custom_generated: successful.filter((r) => r.footprintType === 'generated').length,
   };
 
+  // Compact response - summary only, no detailed failures
+  // (failures can be retrieved separately if needed)
   return {
     content: [{
       type: 'text' as const,
@@ -390,23 +375,19 @@ export async function handleUpdateLibrary(args: unknown) {
         success: true,
         dry_run: params.dry_run,
         summary: {
-          total_components: allLcscIds.size,
+          total: allLcscIds.size,
           updated: successful.length,
           failed: failed.length,
-          libraries_generated: categorySymbols.size,
         },
         by_category: Object.fromEntries(byCategory),
         footprint_stats: footprintStats,
-        libraries_written: params.dry_run
-          ? []
-          : Array.from(categorySymbols.keys()).map((cat) =>
-            join(paths.symbolsDir, getLibraryFilename(cat))
-          ),
-        failed_components: failed.map((f) => ({
+        // Only include first 5 failures to avoid massive responses
+        failed_sample: failed.slice(0, 5).map((f) => ({
           lcsc_id: f.lcscId,
           error: f.error,
         })),
-      }, null, 2),
+        has_more_failures: failed.length > 5,
+      }),
     }],
   };
 }