项目简介

本项目是 Model Context Protocol (MCP) 的一个服务器实现,专为 Adobe Illustrator 设计。它使得遵循MCP协议的LLM客户端能够与Adobe Illustrator进行交互,执行自动化任务,例如创建、修改、或查询文档中的文本、图像和路径对象。

重要提示: 本工具目前仅支持 macOS 系统。

主要功能点

  • 文本操作: 创建新的文本框,获取现有文本框的信息(内容、位置、大小、字体等),修改文本框的属性(文本内容、字体、字号、颜色、对齐方式、位置、大小),以及修改文本框内特定字符范围的属性。
  • 图像操作: 在文档中放置图像,获取文档中已放置图像的信息(路径、位置、大小),修改图像的属性(替换文件、调整位置和大小,可选择保持宽高比)。
  • 路径操作: 在文档中绘制矩形和直线,获取现有路径对象的信息(位置、大小),修改路径对象的属性(填充颜色、描边颜色、描边宽度、位置、大小)。
  • 对象管理: 根据唯一标识符(UUID) 选择、分组或删除文档中的对象。
  • 文档操作: 打开指定的Illustrator文档,复制当前文档的第一个画板及其内容。
  • 辅助工具: 提供简单的表达式计算和文本行字符计数功能。

安装步骤

  1. 克隆仓库: 将项目代码从GitHub克隆到您的本地计算机。
  2. 安装依赖: 进入项目目录,使用 'yarn' 包管理器安装所需的依赖。
    yarn
  3. 构建项目: 运行构建命令以生成可执行的 JavaScript 文件(通常是 'yarn build',尽管仓库中未明确提供,但根据文件路径推断)。
    yarn build
    (如果 'yarn build' 命令不存在,请检查 'package.json' 文件或尝试 'yarn install' 后查看生成的文件)。
  4. 确保 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' 请求获取。

信息

分类

桌面与硬件