项目简介
本项目是 Model Context Protocol (MCP) 的一个服务器实现,专为 Adobe Illustrator 设计。它使得遵循MCP协议的LLM客户端能够与Adobe Illustrator进行交互,执行自动化任务,例如创建、修改、或查询文档中的文本、图像和路径对象。
重要提示: 本工具目前仅支持 macOS 系统。
主要功能点
- 文本操作: 创建新的文本框,获取现有文本框的信息(内容、位置、大小、字体等),修改文本框的属性(文本内容、字体、字号、颜色、对齐方式、位置、大小),以及修改文本框内特定字符范围的属性。
- 图像操作: 在文档中放置图像,获取文档中已放置图像的信息(路径、位置、大小),修改图像的属性(替换文件、调整位置和大小,可选择保持宽高比)。
- 路径操作: 在文档中绘制矩形和直线,获取现有路径对象的信息(位置、大小),修改路径对象的属性(填充颜色、描边颜色、描边宽度、位置、大小)。
- 对象管理: 根据唯一标识符(UUID) 选择、分组或删除文档中的对象。
- 文档操作: 打开指定的Illustrator文档,复制当前文档的第一个画板及其内容。
- 辅助工具: 提供简单的表达式计算和文本行字符计数功能。
安装步骤
- 克隆仓库: 将项目代码从GitHub克隆到您的本地计算机。
- 安装依赖: 进入项目目录,使用 'yarn' 包管理器安装所需的依赖。
yarn - 构建项目: 运行构建命令以生成可执行的 JavaScript 文件(通常是 'yarn build',尽管仓库中未明确提供,但根据文件路径推断)。
(如果 'yarn build' 命令不存在,请检查 'package.json' 文件或尝试 'yarn install' 后查看生成的文件)。yarn build - 确保 Illustrator 运行: 运行此MCP服务器前,请确保您的 macOS 系统上已安装并运行 Adobe Illustrator。
服务器配置
要让MCP客户端连接到此服务器,您需要在客户端的配置中添加此服务器的启动信息。典型的配置会是一个JSON对象,包含服务器的名称、启动命令及其参数。
根据本项目的结构,以下是一个示例配置结构中需要填入的关键信息:
{ "mcpServers": { "您为服务器自定义的名称": { "command": "node", // 启动服务器的命令,这里是 node "args": [ "~/Documents/web/illustrator-mcp/build/index.js" // 启动脚本的路径 ] } } }
请将上述信息添加到您的MCP客户端的相应配置文件中,其中 '"您为服务器自定义的名称"' 可以替换为您易于识别的任何名称(例如 '"illustrator"'),并且 '"~/Documents/web/illustrator-mcp/build/index.js"' 需要替换为您实际克隆和构建项目后,服务器入口文件 ('build/index.js') 的绝对路径。
基本使用方法
在MCP客户端配置好此服务器后,您的LLM或其他MCP客户端即可通过JSON-RPC与服务器通信,发现其暴露的工具(例如 'list_textframes', 'create_rects', 'change_images' 等),并调用这些工具,将 Illustrator 的操作能力整合到LLM驱动的工作流程中。具体的工具名称和参数说明将在客户端连接服务器后通过MCP协议的 'capabilities' 请求获取。
信息
分类
桌面与硬件