Illustrator MCP 服务器 (Windows & macOS)

欢迎使用 Illustrator MCP 服务器！🎨🚀

本项目允许 AI 代理使用自然语言提示词在 Adobe Illustrator 中直接创建矢量图形。它通过本地 MCP (Model Context Protocol) 服务器向 Illustrator 发送 ExtendScript 命令来工作。

想象一下，只需描述你想要的内容——例如 “画一家雨中的小咖啡馆”——Illustrator 就能将其变为现实！

适用于 Windows (COM 自动化) 和 macOS (AppleScript/osascript)。

✨ 功能

使用 AI 提示词以编程方式控制 Adobe Illustrator
直接向 Illustrator 发送 ExtendScript (.jsx) 脚本
截取 Illustrator 窗口的屏幕截图
开源且轻量
跨平台： Windows & macOS
多客户端支持： 适用于 Claude Desktop、Claude Code、Cursor、VS Code Copilot 和 JetBrains Copilot

💻 安装

前置要求

Python 3.12+ — 下载 Python
已安装并运行 Adobe Illustrator
仅限 macOS： 在提示时授予自动化权限（系统设置 → 隐私与安全性 → 自动化）

1. 克隆仓库

git clone https://github.com/krVatsal/illustrator-mcp.git
cd illustrator-mcp

2. 创建虚拟环境

macOS / Linux：

python3 -m venv .venv
source .venv/bin/activate

Windows：

python -m venv .venv
.\.venv\Scripts\activate

3. 安装依赖

pip install -r requirements.txt

在 macOS 上，pywin32 会被自动跳过。无需额外的 macOS 包。

4. 启动 MCP 服务器（手动 / 调试模式）

python -m illustrator

使用单个脚本运行（跨平台）

bash run_server.sh

此脚本会自动检测你的平台、创建 .venv、安装依赖并启动服务器。

🔌 客户端配置

该服务器使用 stdio 传输 — 与所有主流 MCP 客户端兼容。

重要提示： 通过客户端使用时，请勿手动启动服务器。客户端会自动启动并管理服务器进程。

Claude Desktop

macOS — 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "illustrator": {
      "command": "/path/to/illustrator-mcp/.venv/bin/python3",
      "args": ["-m", "illustrator"]
    }
  }
}

Windows — 编辑 %APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "illustrator": {
      "command": "C:\\Users\\<YourUser>\\illustrator-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "illustrator"]
    }
  }
}

Claude Code (CLI)

仓库中包含一个 .claude/mcp.json。Claude Code 将自动检测它。或者手动添加：

claude mcp add illustrator python3 -- -m illustrator

GitHub Copilot (VS Code)

仓库中包含一个 .vscode/mcp.json。VS Code (1.99+) 将自动检测它。或者添加到你的 settings.json 中：

{
  "mcp": {
    "servers": {
      "illustrator": {
        "type": "stdio",
        "command": "python3",
        "args": ["-m", "illustrator"]
      }
    }
  }
}

🎯 增强型提示词系统

此 MCP 服务器现在包含一个高级提示词系统，可帮助你创建更好的内容！使用这些新工具：

get_prompt_suggestions - 获取针对不同类型内容的分类提示词示例
get_system_prompt - 获取用于 AI 指导的最佳系统提示词
get_prompting_tips - 获取创建更有效提示词的技巧
get_advanced_template - 获取复杂设计任务的结构化模板
help - 显示全面的帮助和指南

📚 可用的提示词类别：

🎨 基本形状与几何
📝 排版与文本
🏢 徽标与品牌
🌆 插图与场景
🎭 图标与 UI 元素
🎨 艺术与创意
📊 图表与信息图
🏷️ 打印与布局

💡 提示词快速入门

尝试询问：“获取徽标的提示词建议” 或 “向我展示提示词技巧”

有关详细示例和模板，请参阅 PROMPT_EXAMPLES.md

📋 我尝试过的示例提示词

以下是我使用过的一些提示词及其生成的结果：

提示词 1： 设计一个简洁、极简的矢量艺术作品，描绘一家雨中的小咖啡馆，具有简单的店面、街道上的水坑以及天空中柔和的灰色云朵。
提示词 2： 创建一张日落时分孟买天际线的水彩风格插图。
提示词 3： 为一家名为 'NeuraTech' 的科技初创公司创建一个现代、极简的徽标。

(查看附件图片以获取结果！)

🍎 macOS 注意事项

必须安装并运行 Adobe Illustrator
首次使用时，macOS 会询问 自动化权限 — 允许你的终端/IDE 控制 Illustrator
如果看到“应用程序未运行”错误，请先打开 Illustrator
截图会捕获全屏（Illustrator 应处于前台）

🪟 Windows 注意事项

必须安装 Adobe Illustrator
需要 pywin32 包（已自动安装）
必须启用 Illustrator 脚本功能

📢 贡献

欢迎提交 Pull Request！欢迎随时提出功能请求、报告错误或提供建议。 Stars Forks License

创作愉快！🌈💛

Illustrator MCP Server