使用说明

项目简介

该项目 'illustrator-mcp-server' 旨在作为一个桥梁，连接大型语言模型 (LLM) 与本地 Adobe Illustrator 软件。它基于 Model Context Protocol (MCP) 框架构建，充当 MCP 服务器，允许 LLM 客户端（如 Claude Desktop）通过标准化的协议控制 Illustrator，执行特定操作。由于项目使用了 AppleScript，因此目前仅兼容 macOS 系统。

主要功能点

查看 Illustrator 窗口截图 (view): 允许 LLM 获取当前 Illustrator 窗口的屏幕截图，以便理解界面状态或进行视觉分析。
运行 ExtendScript 代码 (run): 允许 LLM 在 Illustrator 中执行 ExtendScript/JavaScript 代码，实现自动化绘图、设计修改等高级功能。代码将在当前 Illustrator 文档上运行。

安装步骤

克隆仓库: 首先，将该 GitHub 仓库克隆到本地：

git clone https://github.com/MCP-Mirror/spencerhhubert_illustrator-mcp-server
cd spencerhhubert_illustrator-mcp-server

安装 'mcp' 库: 确保你的 Python 环境中安装了 'mcp' 库。如果未安装，请使用 pip 安装：
```
pip install model-context-protocol
```
运行服务器: 导航到 'src/illustrator' 目录，并运行 'server.py' 文件启动 MCP 服务器。建议使用 'uv' 或 'python' 命令，根据 'README.md' 提供的配置，可以使用类似如下命令启动服务器：
```
uv run src/illustrator/server.py
# 或者
python src/illustrator/server.py
```
请注意：确保你的 Python 环境配置正确，并且能够访问到 'mcp' 库。

服务器配置

为了让 MCP 客户端（例如 Claude Desktop）连接到 'illustrator-mcp-server'，需要在客户端的配置文件中添加服务器配置信息。以 'README.md' 中提供的 'claude_desktop_config.json' 为例，配置信息如下：

{
    "mcpServers": {
        "illustrator": {
            "command": "uv",  // 启动服务器的命令，这里假设你使用 uv 运行器
            "args": [         // 命令参数列表
                "--directory",  // 指定工作目录
                "/Users/you/code/mcp/illustrator-mcp-server", //  请替换为你的 'illustrator-mcp-server' 仓库的本地路径
                "run",          // uv 命令的子命令，表示运行 Python 脚本
                "src/illustrator/server.py" //  服务器脚本的路径，相对于工作目录
            ]
        }
    }
}

配置参数说明 (无需修改代码，客户端配置):

'"illustrator"': 服务器的名称，客户端用此名称来标识和调用该服务器。
'"command"': 启动服务器进程的命令。你可以根据你的环境选择 'uv' 或 'python'。如果你直接使用 'python' 命令，请将 'command' 修改为 '"python"'，并将 '"run"' 参数移除。
'"args"': 传递给启动命令的参数列表。
- '"--directory"' 和仓库路径: 指定服务器程序的工作目录，确保程序能找到依赖和资源。 请务必将 '/Users/you/code/mcp/illustrator-mcp-server' 替换为你实际的仓库本地路径。
- '"run"' (仅当 'command' 为 'uv' 时): 'uv' 运行器的子命令，用于执行 Python 脚本。如果 'command' 是 'python'，则不需要此参数。
- '"src/illustrator/server.py"': MCP 服务器 Python 脚本的路径，相对于工作目录。如果你直接运行 'python src/illustrator/server.py'，并且 'command' 设置为 '"python"'，则 'args' 应该简化为仓库路径。

请根据你使用的 MCP 客户端的配置方式，将以上 JSON 配置信息添加到客户端的配置文件中。 Claude Desktop 客户端的配置文件路径通常为 '~/Library/Application Support/Claude/claude_desktop_config.json'。

基本使用方法

启动服务器: 按照安装步骤中的说明启动 'illustrator-mcp-server'。
配置客户端: 将生成的服务器配置信息添加到你的 MCP 客户端配置中，并确保客户端已正确连接到该服务器。
在 LLM 中调用工具: 在支持 MCP 协议的 LLM 应用中，你可以指示 LLM 调用 'illustrator' 服务器提供的工具。
- 调用 'view' 工具，LLM 可以获取 Illustrator 窗口的截图。
- 调用 'run' 工具，并提供 ExtendScript 代码，LLM 可以在 Illustrator 中执行相应的脚本，并获取执行结果。

注意:

该服务器依赖于 macOS 系统和 Adobe Illustrator 软件。
客户端需要支持 MCP 协议才能与该服务器进行通信。
使用 'run' 工具时，请确保提供的 ExtendScript 代码的安全性，并了解其可能对 Illustrator 文档产生的影响。

关键词