illustrator-mcp-server 1.2.5 → 1.2.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/README.ja.md +18 -23
  2. package/README.md +19 -24
  3. package/dist/bundle.cjs +40079 -0
  4. package/dist/executor/jsx-runner.d.ts.map +1 -1
  5. package/dist/executor/jsx-runner.js +7 -1
  6. package/dist/executor/jsx-runner.js.map +1 -1
  7. package/dist/jsx/helpers/common.jsx +79 -0
  8. package/dist/tools/modify/align-objects.d.ts.map +1 -1
  9. package/dist/tools/modify/align-objects.js +8 -1
  10. package/dist/tools/modify/align-objects.js.map +1 -1
  11. package/dist/tools/modify/apply-color-profile.d.ts.map +1 -1
  12. package/dist/tools/modify/apply-color-profile.js +4 -1
  13. package/dist/tools/modify/apply-color-profile.js.map +1 -1
  14. package/dist/tools/modify/apply-graphic-style.d.ts.map +1 -1
  15. package/dist/tools/modify/apply-graphic-style.js +7 -1
  16. package/dist/tools/modify/apply-graphic-style.js.map +1 -1
  17. package/dist/tools/modify/apply-text-style.d.ts.map +1 -1
  18. package/dist/tools/modify/apply-text-style.js +2 -1
  19. package/dist/tools/modify/apply-text-style.js.map +1 -1
  20. package/dist/tools/modify/convert-to-outlines.js +1 -1
  21. package/dist/tools/modify/create-ellipse.js +1 -1
  22. package/dist/tools/modify/create-gradient.d.ts.map +1 -1
  23. package/dist/tools/modify/create-gradient.js +9 -1
  24. package/dist/tools/modify/create-gradient.js.map +1 -1
  25. package/dist/tools/modify/create-line.js +1 -1
  26. package/dist/tools/modify/create-path-text.js +1 -1
  27. package/dist/tools/modify/create-path.js +1 -1
  28. package/dist/tools/modify/create-rectangle.js +1 -1
  29. package/dist/tools/modify/create-text-frame.js +1 -1
  30. package/dist/tools/modify/duplicate-objects.js +1 -1
  31. package/dist/tools/modify/group-objects.d.ts.map +1 -1
  32. package/dist/tools/modify/group-objects.js +2 -1
  33. package/dist/tools/modify/group-objects.js.map +1 -1
  34. package/dist/tools/modify/manage-artboards.d.ts.map +1 -1
  35. package/dist/tools/modify/manage-artboards.js +15 -5
  36. package/dist/tools/modify/manage-artboards.js.map +1 -1
  37. package/dist/tools/modify/manage-datasets.d.ts.map +1 -1
  38. package/dist/tools/modify/manage-datasets.js +224 -5
  39. package/dist/tools/modify/manage-datasets.js.map +1 -1
  40. package/dist/tools/modify/manage-layers.d.ts.map +1 -1
  41. package/dist/tools/modify/manage-layers.js +7 -1
  42. package/dist/tools/modify/manage-layers.js.map +1 -1
  43. package/dist/tools/modify/manage-linked-images.d.ts.map +1 -1
  44. package/dist/tools/modify/manage-linked-images.js +11 -2
  45. package/dist/tools/modify/manage-linked-images.js.map +1 -1
  46. package/dist/tools/modify/manage-swatches.js +3 -3
  47. package/dist/tools/modify/modify-object.d.ts.map +1 -1
  48. package/dist/tools/modify/modify-object.js +3 -2
  49. package/dist/tools/modify/modify-object.js.map +1 -1
  50. package/dist/tools/modify/move-to-layer.d.ts.map +1 -1
  51. package/dist/tools/modify/move-to-layer.js +7 -1
  52. package/dist/tools/modify/move-to-layer.js.map +1 -1
  53. package/dist/tools/modify/open-document.d.ts.map +1 -1
  54. package/dist/tools/modify/open-document.js +2 -0
  55. package/dist/tools/modify/open-document.js.map +1 -1
  56. package/dist/tools/modify/place-color-chips.d.ts.map +1 -1
  57. package/dist/tools/modify/place-color-chips.js +7 -1
  58. package/dist/tools/modify/place-color-chips.js.map +1 -1
  59. package/dist/tools/modify/place-image.d.ts.map +1 -1
  60. package/dist/tools/modify/place-image.js +2 -1
  61. package/dist/tools/modify/place-image.js.map +1 -1
  62. package/dist/tools/modify/place-style-guide.d.ts +3 -0
  63. package/dist/tools/modify/place-style-guide.d.ts.map +1 -0
  64. package/dist/tools/modify/place-style-guide.js +822 -0
  65. package/dist/tools/modify/place-style-guide.js.map +1 -0
  66. package/dist/tools/modify/place-symbol.js +1 -1
  67. package/dist/tools/modify/replace-color.d.ts.map +1 -1
  68. package/dist/tools/modify/replace-color.js +2 -1
  69. package/dist/tools/modify/replace-color.js.map +1 -1
  70. package/dist/tools/modify/resize-for-variation.d.ts.map +1 -1
  71. package/dist/tools/modify/resize-for-variation.js +9 -1
  72. package/dist/tools/modify/resize-for-variation.js.map +1 -1
  73. package/dist/tools/modify/select-objects.d.ts +3 -0
  74. package/dist/tools/modify/select-objects.d.ts.map +1 -0
  75. package/dist/tools/modify/select-objects.js +78 -0
  76. package/dist/tools/modify/select-objects.js.map +1 -0
  77. package/dist/tools/modify/set-z-order.d.ts.map +1 -1
  78. package/dist/tools/modify/set-z-order.js +2 -1
  79. package/dist/tools/modify/set-z-order.js.map +1 -1
  80. package/dist/tools/modify/ungroup-objects.d.ts.map +1 -1
  81. package/dist/tools/modify/ungroup-objects.js +6 -1
  82. package/dist/tools/modify/ungroup-objects.js.map +1 -1
  83. package/dist/tools/read/extract-design-tokens.d.ts.map +1 -1
  84. package/dist/tools/read/extract-design-tokens.js +25 -3
  85. package/dist/tools/read/extract-design-tokens.js.map +1 -1
  86. package/dist/tools/registry.d.ts.map +1 -1
  87. package/dist/tools/registry.js +4 -0
  88. package/dist/tools/registry.js.map +1 -1
  89. package/package.json +5 -3
package/README.ja.md CHANGED
@@ -47,10 +47,17 @@ claude mcp add illustrator-mcp -- npx illustrator-mcp-server
47
47
 
48
48
  ### Claude Desktop
49
49
 
50
- 設定ファイルを開いて、接続情報を書き込みます。
50
+ 1. [GitHub Releases](https://github.com/ie3jp/illustrator-mcp-server/releases/latest) から **`illustrator-mcp-server-x.x.x.mcpb`** をダウンロード
51
+ 2. Claude Desktop を開き、**設定** → **拡張機能** を開く
52
+ 3. ダウンロードした `.mcpb` ファイルを拡張機能パネルにドラッグ&ドロップ
53
+ 4. **インストール** ボタンをクリック
54
+
55
+ > **更新について:** `.mcpb` 拡張機能は自動更新されません。更新するには新しいバージョンをダウンロードして再インストールしてください。自動更新が必要な場合は、下記の npx 方式をお使いください。
51
56
 
52
57
  <details>
53
- <summary><strong>手順を表示</strong></summary>
58
+ <summary><strong>別の方法: 手動設定(npx 経由で常に最新版)</strong></summary>
59
+
60
+ 設定ファイルを開いて、接続情報を書き込みます。
54
61
 
55
62
  #### 1. 設定ファイルを開く
56
63
 
@@ -58,13 +65,8 @@ Claude Desktop のメニューバーから:
58
65
 
59
66
  **Claude** → **設定** → 左サイドバーの **開発者** → **設定を編集** ボタンをクリック
60
67
 
61
- Finderに `claude_desktop_config.json` ファイルが表示されるので、
62
- テキストエディタで `claude_desktop_config.json` を開きます。
63
-
64
68
  #### 2. 設定を書き込む
65
69
 
66
- ファイルが空、または `{}` だけの場合は、**中身をすべて消して**以下をそのままコピー&ペーストしてください:
67
-
68
70
  ```json
69
71
  {
70
72
  "mcpServers": {
@@ -76,25 +78,16 @@ Finderに `claude_desktop_config.json` ファイルが表示されるので、
76
78
  }
77
79
  ```
78
80
 
79
- > すでに他の MCP サーバーが設定されている場合は、`"mcpServers": {` の中に `"illustrator": { ... }` ブロックを追加してください。カンマの付け忘れに注意。
80
-
81
- ```json
82
- "mcpServers": {
83
- "他のサーバ": {
84
- 他のサーバーの設定...
85
- },
86
- "illustrator": {
87
- "command": "npx",
88
- "args": ["illustrator-mcp-server"]
89
- }
90
- }
91
- ```
81
+ > **注意:** nvm / mise / fnm 等のバージョンマネージャで Node.js をインストールした場合、Claude Desktop が `npx` を見つけられないことがあります。その場合はフルパスを指定してください:
82
+ > ```json
83
+ > "command": "/フルパス/npx"
84
+ > ```
85
+ > ターミナルで `which npx` を実行するとパスを確認できます。
92
86
 
93
87
  #### 3. 保存して再起動
94
88
 
95
89
  1. ファイルを保存(⌘S)してテキストエディタを閉じる
96
90
  2. Claude Desktop を **完全に終了**(⌘Q)して再度開く
97
- 3. **Claude** → **設定** → **開発者** を開き、illustrator サーバーが表示されていれば接続成功です
98
91
 
99
92
  </details>
100
93
 
@@ -511,7 +504,7 @@ Claude Code で `/illustrator-preflight:illustrator-preflight` と入力する
511
504
 
512
505
  ## 特徴
513
506
 
514
- - **61 ツール + 2 Prompts** — 読み取り 21 / 操作 35 / 書き出し 2 / ユーティリティ 3
507
+ - **63 ツール + 2 Prompts** — 読み取り 21 / 操作 37 / 書き出し 2 / ユーティリティ 3
515
508
  - **Web 座標系** — デフォルトでアートボード相対・Y 軸下向き正(CSS/SVG と同じ座標系)
516
509
  - **UUID トラッキング** — 全オブジェクトを `pageItem.note` の UUID で一意に識別
517
510
 
@@ -550,7 +543,7 @@ Claude Code で `/illustrator-preflight:illustrator-preflight` と入力する
550
543
 
551
544
  </details>
552
545
 
553
- ### 操作系 (35)
546
+ ### 操作系 (37)
554
547
 
555
548
  <details>
556
549
  <summary>クリックして展開</summary>
@@ -591,6 +584,8 @@ Claude Code で `/illustrator-preflight:illustrator-preflight` と入力する
591
584
  | `create_gradient` | グラデーションの作成・オブジェクトへの適用 |
592
585
  | `create_path_text` | パスに沿ったテキストの作成 |
593
586
  | `place_symbol` | シンボルインスタンスの配置・差し替え |
587
+ | `select_objects` | UUID指定でオブジェクトを選択(複数選択対応) |
588
+ | `place_style_guide` | アートボード外にビジュアルスタイルガイドを配置(カラー・フォント・スペーシング・マージン・ガイド間隔) |
594
589
  | `undo` | 操作の取り消し/やり直し(複数ステップ対応) |
595
590
 
596
591
  </details>
package/README.md CHANGED
@@ -49,10 +49,17 @@ claude mcp add illustrator-mcp -- npx illustrator-mcp-server
49
49
 
50
50
  ### Claude Desktop
51
51
 
52
- Open the config file and add the connection settings.
52
+ 1. Download **`illustrator-mcp-server-x.x.x.mcpb`** from [GitHub Releases](https://github.com/ie3jp/illustrator-mcp-server/releases/latest)
53
+ 2. Open Claude Desktop → **Settings** → **Extensions**
54
+ 3. Drag and drop the `.mcpb` file into the Extensions panel
55
+ 4. Click the **Install** button
56
+
57
+ > **Updating:** The `.mcpb` extension does not auto-update. To update, download the new version and reinstall. If you prefer automatic updates, use the npx method below instead.
53
58
 
54
59
  <details>
55
- <summary><strong>Show step-by-step instructions</strong></summary>
60
+ <summary><strong>Alternative: manual config (always up to date via npx)</strong></summary>
61
+
62
+ Open the config file and add the connection settings.
56
63
 
57
64
  #### 1. Open the config file
58
65
 
@@ -60,13 +67,8 @@ From the Claude Desktop menu bar:
60
67
 
61
68
  **Claude** → **Settings...** → **Developer** (in the left sidebar) → Click the **Edit Config** button
62
69
 
63
- The `claude_desktop_config.json` file will appear in Finder (macOS) or Explorer (Windows).
64
- Open it with a text editor.
65
-
66
70
  #### 2. Add the settings
67
71
 
68
- If the file is empty or contains only `{}`, **replace everything** with the following (copy & paste):
69
-
70
72
  ```json
71
73
  {
72
74
  "mcpServers": {
@@ -78,25 +80,16 @@ If the file is empty or contains only `{}`, **replace everything** with the foll
78
80
  }
79
81
  ```
80
82
 
81
- > If you already have other MCP servers configured, add the `"illustrator": { ... }` block inside the existing `"mcpServers": {` section. Don't forget the comma between entries.
82
-
83
- ```json
84
- "mcpServers": {
85
- "other-server": {
86
- ...other server settings...
87
- },
88
- "illustrator": {
89
- "command": "npx",
90
- "args": ["illustrator-mcp-server"]
91
- }
92
- }
93
- ```
83
+ > **Note:** If you installed Node.js via a version manager (nvm, mise, fnm, etc.), Claude Desktop may not find `npx`. In that case, use the full path:
84
+ > ```json
85
+ > "command": "/full/path/to/npx"
86
+ > ```
87
+ > Run `which npx` in your terminal to find the path.
94
88
 
95
89
  #### 3. Save and restart
96
90
 
97
- 1. Save the file (⌘S / Ctrl+S) and close the text editor
91
+ 1. Save the file and close the text editor
98
92
  2. **Fully quit** Claude Desktop (⌘Q / Ctrl+Q) and reopen it
99
- 3. Open **Claude** → **Settings...** → **Developer** — if the illustrator server appears, the connection is working
100
93
 
101
94
  </details>
102
95
 
@@ -499,7 +492,7 @@ Type `/illustrator-preflight:illustrator-preflight` in Claude Code, or just ask
499
492
 
500
493
  ## Features
501
494
 
502
- - **61 tools + 2 prompts** — 21 read / 35 modify / 2 export / 3 utility
495
+ - **63 tools + 2 prompts** — 21 read / 37 modify / 2 export / 3 utility
503
496
  - **Web coordinate system** — Y-axis down, artboard-relative (same as CSS/SVG)
504
497
  - **UUID tracking** — Stable object identification across tool calls
505
498
 
@@ -538,7 +531,7 @@ Type `/illustrator-preflight:illustrator-preflight` in Claude Code, or just ask
538
531
 
539
532
  </details>
540
533
 
541
- ### Modify Tools (35)
534
+ ### Modify Tools (37)
542
535
 
543
536
  <details>
544
537
  <summary>Click to expand</summary>
@@ -579,6 +572,8 @@ Type `/illustrator-preflight:illustrator-preflight` in Claude Code, or just ask
579
572
  | `create_gradient` | Create gradients and apply to objects |
580
573
  | `create_path_text` | Create text along a path |
581
574
  | `place_symbol` | Place or replace symbol instances |
575
+ | `select_objects` | Select objects by UUID (multi-select supported) |
576
+ | `place_style_guide` | Place a visual style guide outside the artboard (colors, fonts, spacing, margins, guide gaps) |
582
577
  | `undo` | Undo/redo operations (multi-step) |
583
578
 
584
579
  </details>