KiCad MCP Server

Instructions

Implementation Reference

• kicad_mcp/tools/netlist_tools.py:157-276 (handler)

  Core handler implementation decorated with @mcp.tool(). Extracts netlist from schematic, categorizes components by type, identifies power and signal nets, detects potential issues like floating nets, and returns detailed analysis.

  @mcp.tool()
  async def analyze_schematic_connections(schematic_path: str, ctx: Context | None) -> Dict[str, Any]:
      """Analyze connections in a KiCad schematic.
      
      This tool provides detailed analysis of component connections,
      including power nets, signal paths, and potential issues.
      
      Args:
          schematic_path: Path to the KiCad schematic file (.kicad_sch)
          ctx: MCP context for progress reporting
          
      Returns:
          Dictionary with connection analysis
      """
      print(f"Analyzing connections in schematic: {schematic_path}")
      
      if not os.path.exists(schematic_path):
          print(f"Schematic file not found: {schematic_path}")
          if ctx:
              ctx.info(f"Schematic file not found: {schematic_path}")
          return {"success": False, "error": f"Schematic file not found: {schematic_path}"}
      
      # Report progress
      if ctx:
          await ctx.report_progress(10, 100)
          ctx.info(f"Extracting netlist from: {os.path.basename(schematic_path)}")
      
      # Extract netlist information
      try:
          netlist_data = extract_netlist(schematic_path)
          
          if "error" in netlist_data:
              print(f"Error extracting netlist: {netlist_data['error']}")
              if ctx:
                  ctx.info(f"Error extracting netlist: {netlist_data['error']}")
              return {"success": False, "error": netlist_data['error']}
          
          if ctx:
              await ctx.report_progress(40, 100)
          
          # Advanced connection analysis
          if ctx:
              ctx.info("Performing connection analysis...")
          
          analysis = {
              "component_count": netlist_data["component_count"],
              "net_count": netlist_data["net_count"],
              "component_types": {},
              "power_nets": [],
              "signal_nets": [],
              "potential_issues": []
          }
          
          # Analyze component types
          components = netlist_data.get("components", {})
          for ref, component in components.items():
              # Extract component type from reference (e.g., R1 -> R)
              import re
              comp_type_match = re.match(r'^([A-Za-z_]+)', ref)
              if comp_type_match:
                  comp_type = comp_type_match.group(1)
                  if comp_type not in analysis["component_types"]:
                      analysis["component_types"][comp_type] = 0
                  analysis["component_types"][comp_type] += 1
          
          if ctx:
              await ctx.report_progress(60, 100)
          
          # Identify power nets
          nets = netlist_data.get("nets", {})
          for net_name, pins in nets.items():
              if any(net_name.startswith(prefix) for prefix in ["VCC", "VDD", "GND", "+5V", "+3V3", "+12V"]):
                  analysis["power_nets"].append({
                      "name": net_name,
                      "pin_count": len(pins)
                  })
              else:
                  analysis["signal_nets"].append({
                      "name": net_name,
                      "pin_count": len(pins)
                  })
          
          if ctx:
              await ctx.report_progress(80, 100)
          
          # Check for potential issues
          # 1. Nets with only one connection (floating)
          for net_name, pins in nets.items():
              if len(pins) <= 1 and not any(net_name.startswith(prefix) for prefix in ["VCC", "VDD", "GND", "+5V", "+3V3", "+12V"]):
                  analysis["potential_issues"].append({
                      "type": "floating_net",
                      "net": net_name,
                      "description": f"Net '{net_name}' appears to be floating (only has {len(pins)} connection)"
                  })
          
          # 2. Power pins without connections
          # This would require more detailed parsing of the schematic
          
          if ctx:
              await ctx.report_progress(90, 100)
          
          # Build result
          result = {
              "success": True,
              "schematic_path": schematic_path,
              "analysis": analysis
          }
          
          # Complete progress
          if ctx:
              await ctx.report_progress(100, 100)
              ctx.info("Connection analysis complete")
          
          return result
          
      except Exception as e:
          print(f"Error analyzing connections: {str(e)}")
          if ctx:
              ctx.info(f"Error analyzing connections: {str(e)}")
          return {"success": False, "error": str(e)}

• kicad_mcp/server.py:154-154 (registration)

  Invocation of register_netlist_tools(mcp) during server setup, which defines and registers the analyze_schematic_connections tool via @mcp.tool() decorator.

  register_netlist_tools(mcp)