使用说明
项目简介
Illustrator MCP Server 是一个开源项目,它充当桥梁,连接大型语言模型(LLM)客户端(如 Claude Desktop)和 Adobe Illustrator。通过实现 Model Context Protocol (MCP),该服务器允许用户使用自然语言提示,让 LLM 指示 Illustrator 自动创建和编辑矢量图形。用户只需用文字描述想法,Illustrator 就能将其变为现实,极大地提升了设计效率和创意表达的便捷性。
主要功能点
- 自然语言控制 Illustrator: 通过 AI 提示,用户可以使用自然语言直接控制 Adobe Illustrator,无需手动操作复杂的软件界面。
- 脚本化图形生成: 服务器接收来自 LLM 的指令,转化为 Illustrator 可执行的 TypeScript 脚本,实现图形的程序化生成。
- 开放和轻量: 项目代码开源,易于理解和定制,同时保持轻量级,易于部署和运行。
- 兼容 MCP 客户端: 设计上与 Claude Desktop 等 MCP 客户端兼容,理论上也可与其他遵循 MCP 协议的客户端协同工作。
- 提供屏幕截图工具: 提供 "view" 工具,允许客户端获取当前 Adobe Illustrator 窗口的屏幕截图,以便 LLM 理解当前画布状态。
- 执行 ExtendScript 代码: 提供 "run" 工具,允许客户端向 Illustrator 发送并执行 ExtendScript 代码,实现更精细和复杂的功能控制。
安装步骤
-
安装 Python 3.11+: 确保您的系统已安装 Python 3.11 或更高版本。您可以从 Python 官网 下载并安装。
-
克隆仓库: 使用 git 命令克隆 GitHub 仓库到本地:
git clone https://github.com/krVatsal/illustrator-mcp-server.git cd illustrator-mcp-server -
创建虚拟环境 (推荐): 为了隔离项目依赖,建议创建并激活虚拟环境:
python -m venv venv .\venv\Scripts\activate -
安装依赖: 安装项目所需的 Python 库:
pip install -r requirements.txt -
启动 MCP 服务器: 运行 'server.py' 脚本启动 Illustrator MCP 服务器:
python server.py服务器成功启动后,将会在终端输出日志信息,指示服务器正在运行并等待命令。
服务器配置
要让 MCP 客户端(例如 Claude Desktop)连接到 Illustrator MCP Server,您需要配置客户端的 MCP 服务器设置。以 Claude Desktop 为例,您需要编辑其配置文件 'claude_desktop_config.json',通常位于 '%APPDATA%\Claude' 目录下。
在 'mcpServers' 字段中添加或修改配置,指定服务器名称、启动命令和参数。以下是一个配置示例,请根据您的实际情况修改路径:
"mcpServers": { "illustrator": { "command": "python", // 启动服务器的命令,这里使用 python "args": [ "server.py" // 启动服务器的参数,指定运行 server.py 脚本 ], "directory": "/path/to/illustrator-mcp-server" // (可选) 服务器程序所在的目录,如果你的 Claude Desktop 启动时工作目录不是项目根目录,则需要指定。请替换为 illustrator-mcp-server 仓库在您电脑上的实际路径,例如 "C:/Users/YourUsername/Documents/illustrator-mcp-server"。 } }
配置说明:
- '"illustrator"': 服务器名称,客户端通过此名称识别和调用该服务器。
- '"command": "python"': 启动服务器的命令,这里假设您的 Python 可执行文件可以通过 'python' 命令访问。
- '"args": ["server.py"]': 传递给启动命令的参数,指定要运行的服务器脚本为 'server.py'。
- '"directory": "/path/to/illustrator-mcp-server"': (可选) 指定服务器程序所在的目录。如果 Claude Desktop 启动时的当前工作目录与 'server.py' 所在的目录不同,则需要通过 'directory' 参数显式指定,确保客户端能正确找到并执行服务器程序。请务必将 '/path/to/illustrator-mcp-server' 替换为您本地仓库的实际绝对路径。
完成配置后,重启 Claude Desktop 使配置生效。
基本使用方法
-
确保 Illustrator MCP Server 已经成功启动并在后台运行。
-
启动 Adobe Illustrator 软件,并确保已启用脚本支持。
-
打开 Claude Desktop (或其他 MCP 客户端)。
-
在 Claude Desktop 中,您可以指示 Claude 使用 "illustrator" 服务器提供的工具来控制 Illustrator。例如,您可以提示 Claude:
- "使用 illustrator 工具 view 获取当前 Illustrator 窗口的截图"
- "使用 illustrator 工具 run,执行代码:// 这里填写 ExtendScript 代码,例如绘制一个红色矩形"
- "请帮我用 Illustrator 画一个下雨天的咖啡店" (更自然的指令,Claude 需要理解并调用合适的工具)
具体的提示方式和 Claude 的理解能力会影响最终效果,您可能需要根据实际情况调整提示语。
注意: 目前 Claude Desktop 可能不支持设置系统提示,因此在使用时可能需要更明确地引导 Claude 调用 Illustrator 的功能。
信息
分类
桌面与硬件