illustrator-mcp-server 1.0.0

package/dist/tools/read/get-colors.js

@@ -0,0 +1,184 @@
+import { z } from 'zod';
+import { executeJsx } from '../../executor/jsx-runner.js';
+const jsxCode = `
+var preflight = preflightChecks();
+if (preflight) {
+  writeResultFile(RESULT_PATH, preflight);
+} else {
+  try {
+    var params = readParamsFile(PARAMS_PATH);
+    var doc = app.activeDocument;
+    var includeSwatches = (params && typeof params.include_swatches === "boolean") ? params.include_swatches : true;
+    var includeUsedColors = (params && typeof params.include_used_colors === "boolean") ? params.include_used_colors : true;
+
+    var result = {};
+
+    // スウォッチ一覧
+    if (includeSwatches) {
+      var swatches = [];
+      for (var si = 0; si < doc.swatches.length; si++) {
+        var sw = doc.swatches[si];
+        var swInfo = {
+          name: sw.name,
+          color: colorToObject(sw.color)
+        };
+        swatches.push(swInfo);
+      }
+      result.swatches = swatches;
+    }
+
+    // グラデーション一覧
+    var gradients = [];
+    for (var gi = 0; gi < doc.gradients.length; gi++) {
+      var grad = doc.gradients[gi];
+      var gradType = "unknown";
+      try {
+        if (grad.type === GradientType.LINEAR) gradType = "linear";
+        else if (grad.type === GradientType.RADIAL) gradType = "radial";
+        else gradType = grad.type.toString();
+      } catch (e) {}
+
+      var stops = [];
+      for (var gsi = 0; gsi < grad.gradientStops.length; gsi++) {
+        var gs = grad.gradientStops[gsi];
+        var stopInfo = {
+          rampPoint: gs.rampPoint,
+          midPoint: gs.midPoint,
+          color: colorToObject(gs.color)
+        };
+        try { stopInfo.opacity = gs.opacity; } catch (e) { stopInfo.opacity = 100; }
+        stops.push(stopInfo);
+      }
+
+      gradients.push({
+        name: grad.name,
+        type: gradType,
+        stops: stops
+      });
+    }
+    result.gradients = gradients;
+
+    // パターン一覧
+    var patterns = [];
+    for (var pi = 0; pi < doc.patterns.length; pi++) {
+      patterns.push({
+        name: doc.patterns[pi].name
+      });
+    }
+    result.patterns = patterns;
+
+    // 特色（スポットカラー）一覧
+    var spots = [];
+    for (var spi = 0; spi < doc.spots.length; spi++) {
+      var spot = doc.spots[spi];
+      var spotInfo = {
+        name: spot.name
+      };
+      try { spotInfo.color = colorToObject(spot.color); } catch (e) { spotInfo.color = { type: "unknown" }; }
+      try {
+        var st = spot.spotKind;
+        if (st === SpotColorKind.SPOTCMYK) spotInfo.spotKind = "CMYK";
+        else if (st === SpotColorKind.SPOTRGB) spotInfo.spotKind = "RGB";
+        else if (st === SpotColorKind.SPOTLAB) spotInfo.spotKind = "LAB";
+        else spotInfo.spotKind = st.toString();
+      } catch (e) { spotInfo.spotKind = "unknown"; }
+      spots.push(spotInfo);
+    }
+    result.spots = spots;
+
+    // 使用色の収集とメッシュ検出
+    if (includeUsedColors) {
+      var usedFills = [];
+      var usedStrokes = [];
+      var meshItems = [];
+      var spotUsageCount = {};
+
+      for (var ii = 0; ii < doc.pageItems.length; ii++) {
+        var item = doc.pageItems[ii];
+
+        // メッシュアイテム検出
+        if (item.typename === "MeshItem") {
+          meshItems.push(ensureUUID(item));
+          continue;
+        }
+
+        // PathItem の fillColor / strokeColor を収集
+        if (item.typename === "PathItem") {
+          try {
+            if (item.filled) {
+              var fc = colorToObject(item.fillColor);
+              usedFills.push(fc);
+              if (fc.type === "spot") {
+                var spName = fc.name;
+                if (spotUsageCount[spName] === undefined) spotUsageCount[spName] = 0;
+                spotUsageCount[spName] = spotUsageCount[spName] + 1;
+              }
+            }
+          } catch (e) {}
+          try {
+            if (item.stroked) {
+              var sc = colorToObject(item.strokeColor);
+              usedStrokes.push(sc);
+              if (sc.type === "spot") {
+                var spName2 = sc.name;
+                if (spotUsageCount[spName2] === undefined) spotUsageCount[spName2] = 0;
+                spotUsageCount[spName2] = spotUsageCount[spName2] + 1;
+              }
+            }
+          } catch (e) {}
+        }
+      }
+
+      // 特色使用箇所数を spots に追加
+      for (var sci = 0; sci < spots.length; sci++) {
+        var count = spotUsageCount[spots[sci].name];
+        spots[sci].usageCount = (count !== undefined) ? count : 0;
+      }
+
+      result.usedFillColors = usedFills;
+      result.usedStrokeColors = usedStrokes;
+      result.meshGradient = {
+        hasMesh: meshItems.length > 0,
+        meshItemUUIDs: meshItems
+      };
+    }
+
+    writeResultFile(RESULT_PATH, result);
+  } catch (e) {
+    writeResultFile(RESULT_PATH, { error: true, message: "Failed to get color information: " + e.message, line: e.line });
+  }
+}
+`;
+export function register(server) {
+    server.registerTool('get_colors', {
+        title: 'Get Colors',
+        description: 'Get all color information used in the document',
+        inputSchema: {
+            include_swatches: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe('Include swatch list'),
+            include_used_colors: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe('Include used color collection'),
+            coordinate_system: z
+                .enum(['artboard-web', 'document'])
+                .optional()
+                .default('artboard-web')
+                .describe('Coordinate system (artboard-web: artboard-relative Y-down, document: native Illustrator coordinates)'),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        const result = await executeJsx(jsxCode, params);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=get-colors.js.map

package/dist/tools/read/get-colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-colors.js","sourceRoot":"","sources":["../../../src/tools/read/get-colors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoJf,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,gDAAgD;QAC7D,WAAW,EAAE;YACX,gBAAgB,EAAE,CAAC;iBAChB,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,IAAI,CAAC;iBACb,QAAQ,CAAC,qBAAqB,CAAC;YAClC,mBAAmB,EAAE,CAAC;iBACnB,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,IAAI,CAAC;iBACb,QAAQ,CAAC,+BAA+B,CAAC;YAC5C,iBAAiB,EAAE,CAAC;iBACjB,IAAI,CAAC,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;iBAClC,QAAQ,EAAE;iBACV,OAAO,CAAC,cAAc,CAAC;iBACvB,QAAQ,CAAC,sGAAsG,CAAC;SACpH;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/read/get-document-info.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=get-document-info.d.ts.map

package/dist/tools/read/get-document-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-document-info.d.ts","sourceRoot":"","sources":["../../../src/tools/read/get-document-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiHpE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0BhD"}

package/dist/tools/read/get-document-info.js

@@ -0,0 +1,134 @@
+import { z } from 'zod';
+import { executeJsx } from '../../executor/jsx-runner.js';
+const jsxCode = `
+try {
+  var err = preflightChecks();
+  if (err) {
+    writeResultFile(RESULT_PATH, err);
+  } else {
+    var params = readParamsFile(PARAMS_PATH);
+    var doc = app.activeDocument;
+    var coordSystem = (params && params.coordinate_system) ? params.coordinate_system : "artboard-web";
+
+    // ファイル名・パス
+    var fileName = doc.name;
+    var filePath = "";
+    try {
+      filePath = doc.fullName.fsName;
+    } catch (e) {
+      // 未保存ドキュメントの場合 fullName がエラーになる
+      filePath = "";
+    }
+
+    // ドキュメントサイズ（pt）
+    var docWidth = doc.width;
+    var docHeight = doc.height;
+
+    // カラーモード
+    var colorSpace = doc.documentColorSpace;
+    var colorMode = "unknown";
+    if (colorSpace === DocumentColorSpace.CMYK) {
+      colorMode = "CMYK";
+    } else if (colorSpace === DocumentColorSpace.RGB) {
+      colorMode = "RGB";
+    }
+
+    // カラープロファイル
+    var colorProfile = "";
+    try {
+      colorProfile = doc.colorProfileName;
+    } catch (e) {
+      colorProfile = "";
+    }
+
+    // 裁ち落とし設定
+    // Illustrator ExtendScript API はドキュメントの裁ち落とし（bleed）設定を
+    // 直接公開していないため、取得不可
+    var bleed = {
+      note: "Illustrator ExtendScript API does not expose bleed settings directly. Use File > Document Setup to check bleed values.",
+      top: null,
+      bottom: null,
+      left: null,
+      right: null
+    };
+
+    // ラスタライズ解像度
+    var rasterResolution = 0;
+    try {
+      rasterResolution = doc.rasterEffectSettings.resolution;
+    } catch (e) {
+      rasterResolution = 0;
+    }
+
+    // アートボード数・情報
+    var artboardCount = doc.artboards.length;
+    var artboards = [];
+    for (var i = 0; i < doc.artboards.length; i++) {
+      var ab = doc.artboards[i];
+      var rect = ab.artboardRect; // [left, top, right, bottom]
+      var abWidth = rect[2] - rect[0];
+      var abHeight = rect[1] - rect[3]; // top - bottom (Illustrator座標)
+
+      var abInfo = {
+        index: i,
+        name: ab.name
+      };
+
+      if (coordSystem === "document") {
+        abInfo.x = rect[0];
+        abInfo.y = rect[1];
+      } else {
+        // artboard-web: 各アートボードは自身の原点(0,0)を持つ
+        abInfo.x = 0;
+        abInfo.y = 0;
+      }
+      abInfo.width = abWidth;
+      abInfo.height = abHeight;
+
+      artboards.push(abInfo);
+    }
+
+    var result = {
+      fileName: fileName,
+      filePath: filePath,
+      width: docWidth,
+      height: docHeight,
+      colorMode: colorMode,
+      colorProfile: colorProfile,
+      bleed: bleed,
+      rasterEffectResolution: rasterResolution,
+      artboardCount: artboardCount,
+      artboards: artboards,
+      coordinateSystem: coordSystem
+    };
+
+    writeResultFile(RESULT_PATH, result);
+  }
+} catch (e) {
+  writeResultFile(RESULT_PATH, { error: true, message: e.message, line: e.line });
+}
+`;
+export function register(server) {
+    server.registerTool('get_document_info', {
+        title: 'Get Document Info',
+        description: 'Get document metadata',
+        inputSchema: {
+            coordinate_system: z
+                .enum(['artboard-web', 'document'])
+                .optional()
+                .default('artboard-web'),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        const result = await executeJsx(jsxCode, params);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=get-document-info.js.map

package/dist/tools/read/get-document-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-document-info.js","sourceRoot":"","sources":["../../../src/tools/read/get-document-info.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2Gf,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,uBAAuB;QACpC,WAAW,EAAE;YACX,iBAAiB,EAAE,CAAC;iBACjB,IAAI,CAAC,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;iBAClC,QAAQ,EAAE;iBACV,OAAO,CAAC,cAAc,CAAC;SAC3B;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/read/get-document-structure.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=get-document-structure.d.ts.map

package/dist/tools/read/get-document-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-document-structure.d.ts","sourceRoot":"","sources":["../../../src/tools/read/get-document-structure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+FpE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmChD"}

package/dist/tools/read/get-document-structure.js

@@ -0,0 +1,125 @@
+import { z } from 'zod';
+import { executeJsx } from '../../executor/jsx-runner.js';
+const jsxCode = `
+var err = preflightChecks();
+if (err) {
+  writeResultFile(RESULT_PATH, err);
+} else {
+  try {
+    var params = readParamsFile(PARAMS_PATH);
+    var maxDepth = (params.depth !== undefined) ? params.depth : 999;
+    var filterArtboard = (params.artboard_index !== undefined) ? params.artboard_index : -1;
+    var coordSystem = params.coordinate_system || "artboard-web";
+    var doc = app.activeDocument;
+
+    function getArtboardRect(item) {
+      var abIdx = getArtboardIndexForItem(item);
+      if (abIdx >= 0) {
+        return doc.artboards[abIdx].artboardRect;
+      }
+      return null;
+    }
+
+    function shouldIncludeItem(item) {
+      if (filterArtboard < 0) { return true; }
+      var abIdx = getArtboardIndexForItem(item);
+      return abIdx === filterArtboard;
+    }
+
+    function traverseItems(container, currentDepth) {
+      var children = [];
+      if (currentDepth >= maxDepth) { return children; }
+      for (var i = 0; i < container.pageItems.length; i++) {
+        var item = container.pageItems[i];
+        if (!shouldIncludeItem(item)) { continue; }
+        var itemType = getItemType(item);
+        var abRect = getArtboardRect(item);
+        var child = {
+          uuid: ensureUUID(item),
+          name: "",
+          type: itemType,
+          zIndex: getZIndex(item),
+          bounds: getBounds(item, coordSystem, abRect)
+        };
+        try { child.name = item.name || ""; } catch (e) {}
+        if (itemType === "group") {
+          try {
+            child.children = traverseItems(item, currentDepth + 1);
+          } catch (e) {
+            child.children = [];
+          }
+        }
+        children.push(child);
+      }
+      return children;
+    }
+
+    function traverseLayer(layer, currentDepth) {
+      var info = {
+        name: layer.name,
+        visible: layer.visible,
+        locked: layer.locked,
+        zIndex: 0,
+        children: []
+      };
+      try { info.zIndex = layer.zOrderPosition; } catch (e) {}
+
+      if (currentDepth < maxDepth) {
+        info.children = traverseItems(layer, currentDepth);
+
+        // Include sublayers as nested layers
+        for (var s = 0; s < layer.layers.length; s++) {
+          info.children.push(traverseLayer(layer.layers[s], currentDepth + 1));
+        }
+      }
+
+      return info;
+    }
+
+    var layers = [];
+    for (var i = 0; i < doc.layers.length; i++) {
+      layers.push(traverseLayer(doc.layers[i], 0));
+    }
+
+    writeResultFile(RESULT_PATH, {
+      coordinateSystem: coordSystem,
+      layers: layers
+    });
+  } catch (e) {
+    writeResultFile(RESULT_PATH, { error: true, message: "get_document_structure: " + e.message, line: e.line });
+  }
+}
+`;
+export function register(server) {
+    server.registerTool('get_document_structure', {
+        title: 'Get Document Structure',
+        description: 'Get tree structure of layers, groups, and objects',
+        inputSchema: {
+            depth: z
+                .number()
+                .optional()
+                .describe('Maximum traversal depth (unlimited if omitted)'),
+            artboard_index: z
+                .number()
+                .optional()
+                .describe('Filter by artboard index (0-based integer)'),
+            coordinate_system: z
+                .enum(['artboard-web', 'document'])
+                .optional()
+                .default('artboard-web')
+                .describe('Coordinate system (artboard-web: artboard-relative Y-down, document: native Illustrator coordinates)'),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        const result = await executeJsx(jsxCode, params);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=get-document-structure.js.map

package/dist/tools/read/get-document-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-document-structure.js","sourceRoot":"","sources":["../../../src/tools/read/get-document-structure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyFf,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,mDAAmD;QAChE,WAAW,EAAE;YACX,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,gDAAgD,CAAC;YAC7D,cAAc,EAAE,CAAC;iBACd,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,4CAA4C,CAAC;YACzD,iBAAiB,EAAE,CAAC;iBACjB,IAAI,CAAC,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;iBAClC,QAAQ,EAAE;iBACV,OAAO,CAAC,cAAc,CAAC;iBACvB,QAAQ,CAAC,sGAAsG,CAAC;SACpH;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC5E,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/read/get-effects.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=get-effects.d.ts.map

package/dist/tools/read/get-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-effects.d.ts","sourceRoot":"","sources":["../../../src/tools/read/get-effects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoKpE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4BhD"}

package/dist/tools/read/get-effects.js

@@ -0,0 +1,187 @@
+import { z } from 'zod';
+import { executeJsx } from '../../executor/jsx-runner.js';
+const jsxCode = `
+try {
+  var err = preflightChecks();
+  if (err) {
+    writeResultFile(RESULT_PATH, err);
+  } else {
+    var params = readParamsFile(PARAMS_PATH);
+    var coordSystem = (params && params.coordinate_system) ? params.coordinate_system : "artboard-web";
+    var targetUuid = (params && params.target) ? params.target : null;
+    var selectionOnly = (params && params.selection_only === true) ? true : false;
+    var doc = app.activeDocument;
+
+    function blendModeToString(mode) {
+      if (mode === BlendModes.NORMAL) return "normal";
+      if (mode === BlendModes.MULTIPLY) return "multiply";
+      if (mode === BlendModes.SCREEN) return "screen";
+      if (mode === BlendModes.OVERLAY) return "overlay";
+      if (mode === BlendModes.SOFTLIGHT) return "softLight";
+      if (mode === BlendModes.HARDLIGHT) return "hardLight";
+      if (mode === BlendModes.COLORDODGE) return "colorDodge";
+      if (mode === BlendModes.COLORBURN) return "colorBurn";
+      if (mode === BlendModes.DARKEN) return "darken";
+      if (mode === BlendModes.LIGHTEN) return "lighten";
+      if (mode === BlendModes.DIFFERENCE) return "difference";
+      if (mode === BlendModes.EXCLUSION) return "exclusion";
+      if (mode === BlendModes.HUE) return "hue";
+      if (mode === BlendModes.SATURATION) return "saturationBlend";
+      if (mode === BlendModes.COLOR) return "colorBlend";
+      if (mode === BlendModes.LUMINOSITY) return "luminosity";
+      return "unknown";
+    }
+
+    function getEffectInfo(item, coordSys) {
+      var uuid = ensureUUID(item);
+      var zIdx = getZIndex(item);
+      var itemType = getItemType(item);
+      var abIndex = getArtboardIndexForItem(item);
+      var abRect = null;
+      if (abIndex >= 0) { abRect = doc.artboards[abIndex].artboardRect; }
+      var bounds = getBounds(item, coordSys, abRect);
+
+      var info = {
+        uuid: uuid,
+        zIndex: zIdx,
+        name: "",
+        type: itemType,
+        bounds: bounds,
+        opacity: 100,
+        blendingMode: "normal",
+        fill: null,
+        stroke: null,
+        limitations: "ExtendScript DOM cannot access: multiple fills/strokes (only first), live effects parameters, full appearance stack. Only opacity, blendingMode, and primary fill/stroke are returned."
+      };
+
+      try { info.name = item.name || ""; } catch(e) {}
+      try { info.opacity = item.opacity; } catch(e) {}
+      try { info.blendingMode = blendModeToString(item.blendingMode); } catch(e) {}
+
+      // Fill and stroke info for path-like items
+      try {
+        if (itemType === "path") {
+          info.fill = { filled: item.filled };
+          if (item.filled) {
+            info.fill.color = colorToObject(item.fillColor);
+          }
+          info.stroke = { stroked: item.stroked };
+          if (item.stroked) {
+            info.stroke.color = colorToObject(item.strokeColor);
+            info.stroke.width = item.strokeWidth;
+          }
+        } else if (itemType === "compound-path") {
+          if (item.pathItems.length > 0) {
+            var fp = item.pathItems[0];
+            info.fill = { filled: fp.filled };
+            if (fp.filled) {
+              info.fill.color = colorToObject(fp.fillColor);
+            }
+            info.stroke = { stroked: fp.stroked };
+            if (fp.stroked) {
+              info.stroke.color = colorToObject(fp.strokeColor);
+              info.stroke.width = fp.strokeWidth;
+            }
+          }
+        } else if (itemType === "text") {
+          // TextFrameItem does not expose fill/stroke directly in the same way
+          // but we can try character attributes
+          try {
+            if (item.textRanges.length > 0) {
+              var tr = item.textRanges[0];
+              var ca = tr.characterAttributes;
+              info.fill = { filled: true, color: colorToObject(ca.fillColor) };
+              if (ca.strokeWeight > 0) {
+                info.stroke = { stroked: true, color: colorToObject(ca.strokeColor), width: ca.strokeWeight };
+              } else {
+                info.stroke = { stroked: false };
+              }
+            }
+          } catch(e) {}
+        }
+      } catch(e) {}
+
+      return info;
+    }
+
+    var items = [];
+
+    function findByNote(items, uuid) {
+      for (var i = 0; i < items.length; i++) {
+        var item = items[i];
+        try { if (item.note === uuid) return item; } catch(e) {}
+        if (item.typename === "GroupItem") {
+          try {
+            var child = findByNote(item.pageItems, uuid);
+            if (child) return child;
+          } catch(e2) {}
+        }
+      }
+      return null;
+    }
+
+    if (targetUuid) {
+      // Find specific item by UUID
+      var targetItem = null;
+      for (var li = 0; li < doc.layers.length; li++) {
+        targetItem = findByNote(doc.layers[li].pageItems, targetUuid);
+        if (targetItem) break;
+      }
+      if (targetItem) {
+        items.push(getEffectInfo(targetItem, coordSystem));
+      } else {
+        writeResultFile(RESULT_PATH, { error: true, message: "Item not found with UUID: " + targetUuid });
+      }
+    } else if (selectionOnly) {
+      var sel = doc.selection;
+      if (sel && sel.length > 0) {
+        for (var si = 0; si < sel.length; si++) {
+          items.push(getEffectInfo(sel[si], coordSystem));
+        }
+      }
+    } else {
+      var limit = 500;
+      var count = doc.pageItems.length < limit ? doc.pageItems.length : limit;
+      for (var j = 0; j < count; j++) {
+        items.push(getEffectInfo(doc.pageItems[j], coordSystem));
+      }
+    }
+
+    if (!targetUuid || items.length > 0) {
+      writeResultFile(RESULT_PATH, {
+        coordinateSystem: coordSystem,
+        count: items.length,
+        items: items
+      });
+    }
+  }
+} catch (e) {
+  writeResultFile(RESULT_PATH, { error: true, message: e.message, line: e.line });
+}
+`;
+export function register(server) {
+    server.registerTool('get_effects', {
+        title: 'Get Effects',
+        description: 'Get effect and appearance information',
+        inputSchema: {
+            target: z.string().optional().describe('Filter by UUID for a specific object'),
+            selection_only: z.boolean().optional().default(false).describe('Selected objects only'),
+            coordinate_system: z
+                .enum(['artboard-web', 'document'])
+                .optional()
+                .default('artboard-web'),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        const result = await executeJsx(jsxCode, params);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=get-effects.js.map

package/dist/tools/read/get-effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-effects.js","sourceRoot":"","sources":["../../../src/tools/read/get-effects.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Jf,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,uCAAuC;QACpD,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YAC9E,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YACvF,iBAAiB,EAAE,CAAC;iBACjB,IAAI,CAAC,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;iBAClC,QAAQ,EAAE;iBACV,OAAO,CAAC,cAAc,CAAC;SAC3B;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/read/get-groups.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=get-groups.d.ts.map

package/dist/tools/read/get-groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-groups.d.ts","sourceRoot":"","sources":["../../../src/tools/read/get-groups.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuJpE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4BhD"}