Adobe Illustrator MCP Server 使用说明

项目简介

Adobe Illustrator MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在使大型语言模型 (LLM) 能够与 Adobe Illustrator 软件进行交互。通过此服务器,LLM 客户端可以远程控制 Illustrator,执行 ExtendScript 脚本并获取 Illustrator 窗口的截图,从而实现自动化工作流程和更智能的设计辅助功能。

主要功能点

  • 查看 Illustrator 截图 (view): 允许 LLM 获取当前 Adobe Illustrator 窗口的屏幕截图,以便理解 Illustrator 的界面状态和内容。
  • 运行 ExtendScript 代码 (run): 允许 LLM 在 Adobe Illustrator 中执行 ExtendScript/JavaScript 代码,实现对 Illustrator 的编程控制,例如创建、修改或导出设计元素。

安装步骤

  1. 克隆仓库: 首先,你需要克隆 GitHub 仓库到本地:
    git clone https://github.com/spencerhhubert/illustrator-mcp-server
    cd illustrator-mcp-server
  2. 安装 Python 依赖 (如果需要): 虽然代码中没有明确的 'requirements.txt' 文件,但根据代码内容,可能需要安装 'mcp' 和 'Pillow' 库。你可以使用 'pip' 或 'uv' 进行安装。 假设你已经安装了 'uv',可以尝试运行(如果 'mcp' 库还未安装,可能需要手动安装,例如 'pip install mcp' 或 'uv pip install mcp'):
    uv install .  # 或者使用 pip: pip install .
    如果 'mcp' 库未打包在此仓库内,你可能需要先安装 'mcp' 库,例如:
    uv pip install python-mcp-server  # 或者 pip install python-mcp-server (根据实际 mcp 库名称)
    uv install pillow # 或者 pip install pillow
    请根据实际情况安装 'mcp' 库及其依赖。

服务器配置

要将此 MCP 服务器与 MCP 客户端(例如 Claude)连接,你需要配置客户端以指向此服务器。以 Claude Desktop 为例,你需要编辑其配置文件 '~/Library/Application Support/Claude/claude_desktop_config.json' (macOS)。在 'mcpServers' 部分添加或修改 'illustrator' 服务器的配置:

{
    "mcpServers": {
        "illustrator": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/illustrator-mcp-server",  // 将 "/path/to/illustrator-mcp-server" 替换为你本地仓库的绝对路径
                "run",
                "illustrator"
            ]
        }
    }
}

配置参数说明:

  • 'server name': 'illustrator' - 服务器的名称,客户端通过此名称识别服务器。
  • 'command': 'uv' - 用于启动服务器的命令。这里假设你使用 'uv' 包管理器来运行,并且 'uv' 命令在你的系统 PATH 环境变量中。如果使用 'pip' 安装,并且想直接用 Python 运行,'command' 可能是 'python', 'args' 可能是 '["-m", "illustrator.server"]'。 但根据仓库 'README.md' 提供的配置,这里使用 'uv' 更为贴切。
  • 'args': 启动服务器命令的参数列表。
    • '--directory': 指定服务器代码所在的目录,这里需要替换为你的 'illustrator-mcp-server' 仓库的绝对路径。
    • 'run': 'uv run' 的子命令,用于运行指定的 Python 包。
    • 'illustrator': 指定要运行的 Python 包名称,对应 'src/illustrator/init.py' 定义的包。

请务必将 '/path/to/illustrator-mcp-server' 替换为你实际克隆仓库的绝对路径。

基本使用方法

配置完成后,启动你的 MCP 客户端 (如 Claude)。客户端应该能够检测到名为 'illustrator' 的 MCP 服务器。你可以通过客户端的界面或指令,调用服务器提供的工具,例如:

  • 请求客户端调用 'view' 工具,以获取 Illustrator 窗口的截图。
  • 请求客户端调用 'run' 工具,并提供 ExtendScript 代码作为参数,让服务器在 Illustrator 中执行该代码。

具体的调用方式取决于你使用的 MCP 客户端的功能和界面。请参考你的 MCP 客户端的使用文档来了解如何利用配置的 MCP 服务器。

注意: 该服务器依赖 AppleScript,因此仅兼容 macOS 系统,并且作者仅在 Claude Desktop 上进行了测试。

信息

分类

桌面与硬件