Folder Block Updater for AutoCAD (MCP)
======================================

Lets your AI assistant bring the blocks in every drawing in a folder up to date from your block library drawing, or replace one block with another, in one go.
(日本語の説明は README-ja.txt をご覧ください。)


1. Install (about 2 minutes)
----------------------------
Claude Desktop (no settings file to edit)
(1) Download the extension file (.mcpb) from the page where you got this app. You do not need to unzip anything.
(2) Open Claude Desktop and go to Settings -> Extensions.
(3) Drag the .mcpb file onto that page, then press Install.
    (If dragging does not work: Advanced settings -> Install Extension... on the same page, and choose the file.)
(4) Start a new chat and ask "Which Folder Block Updater tools can you use?" The AI lists them and you are ready.

Other AI clients (MCP settings)
(1) Unzip this file anywhere, for example: C:\Tools\folder-block-updater
(2) Add the server to the MCP settings of your AI client (change the path to where you unzipped it; write each \ in the path twice).

    {
      "mcpServers": {
        "folder-block-updater": {
          "command": "C:\\Tools\\folder-block-updater\\py\\python.exe",
          "args": ["-m", "zumen_check.server_blk"]
        }
      }
    }

(3) Quit the AI client and start it again.

You do not need to install Python. It is included in this folder.


2. Use
------
Keep one drawing that holds the current version of your blocks (your block library drawing). Then:

(1) Ask the AI which blocks the drawings use:
      "List the blocks in the drawings in C:\Drawings\ProjectA and mark the ones that are in C:\Standards\blocks.dwg"
(2) Ask it to show what an update would change:
      "Show me what would change if the blocks in C:\Drawings\ProjectA are updated from C:\Standards\blocks.dwg"
    For each drawing you see the blocks that would be updated and how many times each one is placed.
    If the new block has other attributes than the old one, you also see which attributes would be added and which would be
    removed, with the number of values that would be lost.
(3) Ask it to do the update:
      "Update them and save the drawings in a folder named Updated"
      "Update only the blocks DOOR-900 and VALVE and save the drawings in a folder named Updated"
(4) To replace one block with another everywhere:
      "In C:\Drawings\ProjectA replace the block SYM-OLD with SYM-NEW from C:\Standards\blocks.dwg and save in a folder named Updated"

    The updated drawings are saved in a separate folder under the same file names. The original files are not changed.
    (Drawings with nothing to change are not saved. A file that already exists in that folder is not overwritten.)

Good to know
    Every placed block keeps its position, scale, rotation and layer, and the attribute values with the same tag.
    When the new block has a different base point, the placed blocks are shifted so that nothing moves on the sheet.
    Blocks are updated in model space, in layouts and inside other blocks. Nested blocks and layers the new block needs are brought in.
    Dynamic blocks, and blocks whose attributes hold an auto-updating field, are left as they are and listed with the reason.
    Each saved copy is checked: the number of placed blocks and the attribute values are compared with the drawing before the update.
    If a drawing in the folder is open in AutoCAD right now, that one is skipped and you are told which.
    For DWG files, keep AutoCAD running (each drawing is opened and closed in turn; the drawing you are working on stays as it is).
    The library drawing for DWG files is a .dwg file. DXF files can be handled without AutoCAD running, with a .dxf library drawing.


3. Free and subscription
------------------------
Free: listing the blocks, and previewing what an update or a replacement would change.
Subscription: saving the updated drawings.

Subscribe: https://ai-pick.tech/autocad/block-update/
After subscribing, give the AI the license key shown on the purchase-complete page (once):
      "My license key is ...... Please register it."
To cancel, change the card or get receipts, ask the AI "I want to manage my subscription" and it gives you the link.
The subscription check sends only the license key to the server. No drawing data is sent.


4. Help
-------
If something does not work, you lost your key, or you would like another feature added, write to contact@gramshift.com.
The most requested items go into the next version first.
