OpenSCAD MCP Server

Instructions

Implementation Reference

• src/openscad_mcp/server.py:771-828 (handler)

  The check_openscad tool handler function. Decorated with @mcp.tool for automatic registration. Checks OpenSCAD installation by calling find_openscad helper, runs --version command, and returns status information.
  @mcp.tool async def check_openscad( include_paths: bool = False, ctx: Optional[Context] = None, ) -> Dict[str, Any]: """ Verify OpenSCAD installation and return version info. Args: include_paths: Include searched paths in response ctx: MCP context for logging Returns: Dict with OpenSCAD installation information """ if ctx: await ctx.info("Checking OpenSCAD installation...") openscad_path = find_openscad() if not openscad_path: searched = [ "/usr/bin/openscad", "/usr/local/bin/openscad", "/Applications/OpenSCAD.app/Contents/MacOS/OpenSCAD", "C:\\Program Files\\OpenSCAD\\openscad.exe", ] return { "installed": False, "version": None, "path": None, "searched_paths": searched if include_paths else None, "message": "OpenSCAD not found. Please install from https://openscad.org", } # Get version try: result = subprocess.run( [openscad_path, "--version"], capture_output=True, text=True, check=False, ) version = result.stdout.strip() if result.stdout else "Unknown" except Exception: version = "Unknown" if ctx: await ctx.info(f"Found OpenSCAD at {openscad_path}") return { "installed": True, "version": version, "path": str(openscad_path), "message": f"OpenSCAD is installed at {openscad_path}", }
• src/openscad_mcp/server.py:40-73 (helper)

  Helper function used by check_openscad to locate the OpenSCAD executable by checking config, common names, and installation paths.
  def find_openscad() -> Optional[str]: """Find OpenSCAD executable on the system.""" config = get_config() # Check configured path first if config.openscad_path and Path(config.openscad_path).exists(): return config.openscad_path # Common OpenSCAD executable names candidates = ["openscad", "OpenSCAD", "openscad.exe"] for cmd in candidates: try: subprocess.run([cmd, "--version"], capture_output=True, check=False) return cmd except FileNotFoundError: continue # Check common installation paths common_paths = [ "/usr/bin/openscad", "/usr/local/bin/openscad", "/snap/bin/openscad", "/var/lib/flatpak/exports/bin/org.openscad.OpenSCAD", "/Applications/OpenSCAD.app/Contents/MacOS/OpenSCAD", "C:\\Program Files\\OpenSCAD\\openscad.exe", "C:\\Program Files (x86)\\OpenSCAD\\openscad.exe", ] for path in common_paths: if Path(path).exists(): return path return None
• src/openscad_mcp/server.py:771-771 (registration)

  The @mcp.tool decorator registers the check_openscad function as an MCP tool.
  @mcp.tool