kcaa 0.2.2__tar.gz → 0.2.3__tar.gz

{kcaa-0.2.2 → kcaa-0.2.3}/.gitignore

@@ -73,6 +73,7 @@ fp-info-cache
 *.kicad_pcb-bak
 *.kicad_sch-bak
 *.kicad_pro-bak
+**/.versions/
 *.kicad_prl
 *.kicad_prl-bak
 *.kicad_sch.lck

{kcaa-0.2.2 → kcaa-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: kcaa
-Version: 0.2.2
+Version: 0.2.3
 Summary: Model Context Protocol (MCP) server for KiCad electronic design automation (EDA) files
 Project-URL: Homepage, https://github.com/paul356/KiCad-AI-Assistant
 Project-URL: Bug Tracker, https://github.com/paul356/KiCad-AI-Assistant/issues
@@ -292,6 +292,9 @@ kcaa
 | `list_footprint_libraries` | List all available footprint libraries |
 | `search_footprints` | Search footprints by name, description, or tag |
 | `get_footprint_details` | Get footprint details (pads, bounding box, etc.) |
+| `find_footprints_not_in_libraries` | List board footprints missing from every indexed library |
+| `create_footprint_library` | Create a global 3rdparty or project-local footprint library |
+| `add_footprints_to_library` | Export explicitly named board footprints into a library |
 
 ### PCB Query
 
@@ -323,7 +326,7 @@ kcaa
 
 | Tool | Description |
 |------|-------------|
-| `set_footprint_position` | Move and/or rotate a single footprint |
+| `set_footprint_position` | Move and/or rotate one or more footprints (via `items`) |
 | `flip_footprint` | Flip a footprint between top and bottom layer |
 | `align_footprints` | Align footprints to the same axis |
 | `distribute_footprints` | Distribute footprints evenly along an axis |
@@ -371,9 +374,9 @@ kcaa
 
 | Tool | Description |
 |------|-------------|
-| `save_file_version` | Save a version snapshot for rollback |
-| `list_file_versions` | List saved version snapshots |
-| `restore_file_version` | Restore to a previously saved version |
+| `save_project_version` | Save a project version archive (schematic+PCB+project file) |
+| `list_project_versions` | List saved project version archives |
+| `restore_project_version` | Restore project files together to a saved archive |
 | `generate_pcb_thumbnail` | Render a PCB thumbnail image |
 | `generate_project_thumbnail` | Render a project thumbnail |
 

{kcaa-0.2.2 → kcaa-0.2.3}/README.md

@@ -253,6 +253,9 @@ kcaa
 | `list_footprint_libraries` | List all available footprint libraries |
 | `search_footprints` | Search footprints by name, description, or tag |
 | `get_footprint_details` | Get footprint details (pads, bounding box, etc.) |
+| `find_footprints_not_in_libraries` | List board footprints missing from every indexed library |
+| `create_footprint_library` | Create a global 3rdparty or project-local footprint library |
+| `add_footprints_to_library` | Export explicitly named board footprints into a library |
 
 ### PCB Query
 
@@ -284,7 +287,7 @@ kcaa
 
 | Tool | Description |
 |------|-------------|
-| `set_footprint_position` | Move and/or rotate a single footprint |
+| `set_footprint_position` | Move and/or rotate one or more footprints (via `items`) |
 | `flip_footprint` | Flip a footprint between top and bottom layer |
 | `align_footprints` | Align footprints to the same axis |
 | `distribute_footprints` | Distribute footprints evenly along an axis |
@@ -332,9 +335,9 @@ kcaa
 
 | Tool | Description |
 |------|-------------|
-| `save_file_version` | Save a version snapshot for rollback |
-| `list_file_versions` | List saved version snapshots |
-| `restore_file_version` | Restore to a previously saved version |
+| `save_project_version` | Save a project version archive (schematic+PCB+project file) |
+| `list_project_versions` | List saved project version archives |
+| `restore_project_version` | Restore project files together to a saved archive |
 | `generate_pcb_thumbnail` | Render a PCB thumbnail image |
 | `generate_project_thumbnail` | Render a project thumbnail |
 

{kcaa-0.2.2 → kcaa-0.2.3}/README_CN.md

@@ -252,6 +252,9 @@ kcaa
 | `list_footprint_libraries` | 列出所有可用封装库 |
 | `search_footprints` | 按名称/描述/标签搜索封装 |
 | `get_footprint_details` | 获取封装详情（焊盘、边界框等） |
+| `find_footprints_not_in_libraries` | 列出板上缺失于所有已索引库的封装 |
+| `create_footprint_library` | 创建全局 3rdparty 或项目级封装库 |
+| `add_footprints_to_library` | 将显式指定的板载封装导出到库 |
 
 ### PCB 查询
 
@@ -283,7 +286,7 @@ kcaa
 
 | 工具 | 说明 |
 |------|------|
-| `set_footprint_position` | 移动/旋转单个封装 |
+| `set_footprint_position` | 批量移动/旋转一个或多个封装 |
 | `flip_footprint` | 将封装在顶层/底层之间翻转 |
 | `align_footprints` | 将封装对齐到同一坐标轴 |
 | `distribute_footprints` | 沿坐标轴等间距分布封装 |
@@ -331,9 +334,9 @@ kcaa
 
 | 工具 | 说明 |
 |------|------|
-| `save_file_version` | 保存版本快照以便回退 |
-| `list_file_versions` | 列出已保存的版本快照 |
-| `restore_file_version` | 恢复到之前保存的版本 |
+| `save_project_version` | 保存项目版本归档（原理图+PCB+项目文件） |
+| `list_project_versions` | 列出已保存的项目版本归档 |
+| `restore_project_version` | 将项目文件一起恢复到已保存的归档 |
 | `generate_pcb_thumbnail` | 渲染 PCB 缩略图 |
 | `generate_project_thumbnail` | 渲染项目缩略图 |
 

{kcaa-0.2.2 → kcaa-0.2.3}/kcaa/server.py

@@ -6,11 +6,12 @@ Two server profiles are supported, selected via the KICAD_MCP_PROFILE environmen
   full   (default) — registers all tools, resources, and prompts. Intended for
                      standalone MCP clients such as Claude Desktop.
 
-  plugin            — registers only the skip-based schematic editing tools
-                     (netlist, symbol, component, wire/junction). No resources,
-                     no prompts, no kicad-cli-dependent tools. Intended for the
-                     KiCad plugin integration where the plugin supplies project
-                     context directly and the LLM drives editing via tool calls.
+  plugin            — registers the skip-based schematic/PCB editing tools
+                     plus the ``get_project_structure`` query tool. No
+                     resources, no prompts, no kicad-cli-dependent tools.
+                     Intended for the KiCad plugin integration where the
+                     plugin supplies project context directly and the LLM
+                     drives editing via tool calls.
 """
 
 import atexit
@@ -40,6 +41,7 @@ from kcaa.tools.pcb_query_tools import register_pcb_query_tools
 from kcaa.tools.pcb_routing_tools import register_pcb_routing_tools
 from kcaa.tools.pcb_zone_tools import register_pcb_zone_tools
 from kcaa.tools.placement_helpers import register_placement_helpers
+from kcaa.tools.project_tools import register_project_tools
 from kcaa.tools.schematic_group_tools import register_schematic_group_tools
 from kcaa.tools.sheet_tools import register_sheet_tools
 from kcaa.tools.skill_tools import register_skill_tools
@@ -110,9 +112,12 @@ def register_signal_handlers(server: FastMCP) -> None:
 
 
 def _register_plugin_profile(mcp: FastMCP) -> None:
-    """Register only the skip-based schematic/PCB editing tools + IPC-based tools for the plugin profile."""
+    """Register the skip-based schematic/PCB editing tools + IPC-based tools for the plugin profile."""
     logging.info("Registering plugin profile: schematic + PCB tools")
     register_netlist_tools(mcp)
+    # Project structure query for the plugin LLM; keep full-profile
+    # management tools (list_projects/open_project) out of this profile.
+    register_project_tools(mcp, tools=("get_project_structure",))
     register_symbol_tools(mcp)
     register_symbol_edit_tools(mcp)
     register_sheet_tools(mcp)
@@ -205,8 +210,9 @@ def create_server(profile: ServerProfile = "full") -> FastMCP:
     Args:
         profile: Server capability profile.
             "full"   — all tools, resources, and prompts (default; for Claude Desktop etc.)
-            "plugin" — plugin-facing profile: 26 skip-based schematic editing tools only,
-                       no resources, no prompts, no kicad-cli-dependent tools.
+            "plugin" — plugin-facing profile: skip-based schematic/PCB editing
+                       tools plus the get_project_structure query tool; no
+                       resources, no prompts, no kicad-cli-dependent tools.
                        Override via KICAD_MCP_PROFILE env var.
     """
     # Allow env var to override the profile argument; strip whitespace/case variants

{kcaa-0.2.2 → kcaa-0.2.3}/kcaa/tools/pcb_edit_tools.py

@@ -309,47 +309,120 @@ def register_pcb_edit_tools(mcp: FastMCP) -> None:
     @mcp.tool()
     async def set_footprint_property(
         pcb_path: str,
-        reference: str,
-        property_name: str,
-        value: str,
+        items: list[dict[str, Any]],
         ctx: Context | None,
-    ) -> dict[str, str]:
-        """Update a property of a footprint on the PCB board.
+    ) -> dict[str, Any]:
+        """Update a property on footprints of the PCB board.
 
         Common property names: ``Reference``, ``Value``, ``Datasheet``,
         ``Description``.  Custom user fields are also supported.
 
+        Each item in *items* carries its own property and value
+        (``{"reference": ..., "property_name": ..., "value": ...}``).
+        All items are processed in one parse + one save (single ``.bak``).
+        Partial-apply: a footprint that cannot be found or lacks the
+        property keeps its own error in ``results`` while the remaining
+        footprints are still applied and saved.  Empty, duplicate, or
+        malformed items are rejected up front.
+
         A .kicad_pcb.bak backup is created before writing.
+
+        Args:
+            pcb_path: Absolute path to the .kicad_pcb file.
+            items: List of per-footprint specs, e.g. ``[{"reference":
+                "R1", "property_name": "Value", "value": "22k"}]``.
+                Keys: ``reference`` (str, required, unique),
+                ``property_name`` (str, required),
+                ``value`` (str, required).
+
+        Returns:
+            dict with: results (per-footprint {reference, property_name,
+            previous_value, new_value} or {reference, error}),
+            success (all applied), count, applied_count, failure_count,
+            backup_path, pcb_path.
         """
+        _ITEM_KEYS = {"reference", "property_name", "value"}
+        if not items:
+            return {"error": "items must not be empty"}
+        for item in items:
+            if not isinstance(item, dict):
+                return {"error": "each item must be a dict with reference, property_name, value"}
+            unknown = set(item) - _ITEM_KEYS
+            if unknown:
+                return {
+                    "error": f"Unknown item fields: {sorted(unknown)}. Valid: {sorted(_ITEM_KEYS)}"
+                }
+            ref = item.get("reference")
+            if not isinstance(ref, str) or not ref:
+                return {"error": "items must not contain empty or missing references"}
+            if not isinstance(item.get("property_name"), str) or not item["property_name"]:
+                return {"error": "items must contain a non-empty property_name"}
+            if not isinstance(item.get("value"), str):
+                return {"error": "items must contain a string value"}
+        refs = [item["reference"] for item in items]
+        if len(set(refs)) != len(refs):
+            return {"error": "items must not contain duplicate references"}
+
         data = load_pcb(pcb_path)
-        try:
-            fp = find_footprint(data, reference)
-        except KeyError as exc:
-            return {"error": str(exc)}
 
-        old_value = get_fp_property(fp, property_name)
-        if old_value is None:
+        def apply_one(item: dict[str, Any]) -> dict[str, Any]:
+            ref = item["reference"]
+            name = item["property_name"]
+            val = item["value"]
+            try:
+                fp = find_footprint(data, ref)
+            except KeyError as exc:
+                return {"error": str(exc), "reference": ref}
+
+            old_value = get_fp_property(fp, name)
+            if old_value is None:
+                return {
+                    "error": (
+                        f"Property '{name}' not found on footprint '{ref}'. "
+                        f"Use get_footprint to see available properties."
+                    ),
+                    "reference": ref,
+                }
+
+            updated = set_fp_property(fp, name, val)
+            if not updated:
+                return {
+                    "error": f"Failed to update property '{name}' on '{ref}'.",
+                    "reference": ref,
+                }
+
             return {
-                "error": (
-                    f"Property '{property_name}' not found on footprint '{reference}'. "
-                    f"Use get_footprint to see available properties."
-                )
+                "success": True,
+                "reference": ref,
+                "property_name": name,
+                "previous_value": old_value,
+                "new_value": val,
             }
 
-        updated = set_fp_property(fp, property_name, value)
-        if not updated:
-            return {"error": f"Failed to update property '{property_name}' on '{reference}'."}
+        results: list[dict[str, Any]] = []
+        for item in items:
+            ref = item["reference"]
+            try:
+                results.append(apply_one(item))
+            except Exception as exc:
+                log.warning("set_footprint_property: reference %r failed: %s", ref, exc)
+                results.append({"error": f"{ref}: {exc}", "reference": ref})
 
-        try:
-            backup_path = save_pcb(pcb_path, data)
-        except OSError as exc:
-            return {"error": f"Failed to write PCB file: {exc}"}
+        applied_count = sum(1 for r in results if r.get("success"))
+
+        backup_path: str | None = None
+        if applied_count > 0:
+            try:
+                backup_path = save_pcb(pcb_path, data)
+            except OSError as exc:
+                return {"error": f"Failed to write PCB file: {exc}"}
 
         return {
-            "reference": reference,
-            "property_name": property_name,
-            "previous_value": old_value,
-            "new_value": value,
+            "success": applied_count == len(results) and len(results) > 0,
+            "results": results,
+            "count": len(results),
+            "applied_count": applied_count,
+            "failure_count": len(results) - applied_count,
             "backup_path": backup_path,
             "pcb_path": pcb_path,
         }