内容
# InDesign MCP
**使用 AI 控制 Adobe InDesign.** 99 种工具可供任何支持 MCP 的 AI 客户端（Claude Desktop、OpenAI Agent SDK、...）使用 — 布局、排版、样式、GREP 查找/替换、主页面、表格、目录/索引、模板和数据合并、导出和预检。实时验证 InDesign 2026。
[](LICENSE.md)
[](https://github.com/Rinellasky/indesign-mcp/releases/latest)
> 基于 [mikechambers/adb-mcp](https://github.com/mikechambers/adb-mcp)（MIT）扩展而来。
> 不代表 Adobe 或与其有关联。
## 功能
- 从提示构建完整文档：*"布局一个 4 页的通讯，带有 2 列网格、运行标题和自动分页号"*
- 大规模排版：创建和应用段落/字符/对象样式，GREP 重置整个文档，首字母大写，基准线网格
- 发布流程工作：目录、索引、交叉引用、数据合并、书籍（.indb）、PDF/IDML/EPUB 导出、预检、印刷包装
- 模板填充：使用结构化数据中的文本和图像填充命名框架
## 工作原理
```
AI 客户端 <-> MCP 服务器（.dxt） <-> 代理（localhost:3001） <-> UXP 插件 <-> InDesign
```
三个部分，全部包含在每个[版本](https://github.com/Rinellasky/indesign-mcp/releases/latest)中：
| 文件 | 说明 |
|---|---|
| `indesign-mcp.dxt` | MCP 服务器 — **双击安装到 Claude Desktop** |
| `indesign-mcp-plugin.ccx` | InDesign UXP 插件 — 双击，Creative Cloud 安装 |
| `adb-proxy-socket-win-x64.exe` | 预编译的代理服务器（Windows） |
| `adb-proxy-socket-macos-x64` / `-arm64` | 预编译的代理服务器（macOS Intel / Apple Silicon） |
代理服务器是必需的，因为 UXP 插件只能连接到套接字 — 它们不能作为服务器监听 — 因此它桥接 MCP 服务器和插件。
## 安装
### 一行命令（Windows）
```powershell
irm https://raw.githubusercontent.com/Rinellasky/indesign-mcp/main/install/install.ps1 | iex
```
安装 MCP 服务器到 Claude Desktop，下载代理服务器，并安装 InDesign 插件（通过 Creative Cloud）。还剩两个手动步骤：启动代理服务器，并在 InDesign 的 *InDesign MCP Agent* 面板中单击 **Connect**。
### 手动安装（Windows 和 macOS，共 3 步）
1. **MCP 服务器** — 从 [最新版本](https://github.com/Rinellasky/indesign-mcp/releases/latest) 下载 `indesign-mcp.dxt`，双击它，然后重启 Claude Desktop。
需要 [`uv`](https://docs.astral.sh/uv/) 在 PATH 中。
2. **代理服务器** — 运行 `adb-proxy-socket-win-x64.exe`（Windows）或
`chmod +x ./adb-proxy-socket-macos-arm64 && ./adb-proxy-socket-macos-arm64`（macOS）。
让它运行 — 您应该看到 `Command proxy server running on ws://localhost:3001`。
3. **InDesign 插件** — 双击 `indesign-mcp-plugin.ccx`（Creative Cloud 安装）。在 InDesign 中，打开 **Plugins → InDesign MCP Agent** 并单击 **Connect**。
### 让 AI 为您安装
将任何具有 shell 访问权限的代理（Claude Desktop、Cowork、Claude Code、...）指向
[`install/INSTALL_VIA_AI.md`](install/INSTALL_VIA_AI.md)：
> *按照 https://github.com/Rinellasky/indesign-mcp/blob/main/install/INSTALL_VIA_AI.md 的说明安装 InDesign MCP*
## 要求
- Adobe InDesign 20.2（2025/2026）或更新版本
- 支持 MCP 的 AI 客户端（在 Windows 和 macOS 上使用 Claude Desktop 进行测试）
- [`uv`](https://docs.astral.sh/uv/) 在 PATH 中（MCP 服务器通过 uv 在 Python 上运行）
## 使用
1. 启动代理服务器，连接 InDesign 中的插件面板，启动 AI 客户端。
2. **首先加载说明资源** — 在 Claude Desktop 中，单击聊天输入框中的 **+** → *从 Adobe InDesign 添加* → `config://get_instructions`。这使 AI 具备使用指南，并大大减少错误。
3. 用自然语言提示 — 不需要 API 名称：
```
创建带有 2 列文本布局和粗体标题的 Letter 大小文档
将这些溢出的文本框架线程到新页面
创建段落样式“正文”（11pt，14pt 行距）并将其应用于整个故事
使用 GREP 替换所有双空格为单空格
从我的标题样式生成目录
将第 1-4 页导出为可打印的 PDF
```
### 提示
- AI 可以提取任何页面作为图像（`get_page_image`）并直观地检查其工作 — 请求它。
- 每次文本更改都会报告每个框架的溢出状态，因此 AI 知道文本是否溢出。
- 长时间导出（PDF/EPUB/包装）可能会超出工具调用超时，但仍会成功 —
检查输出文件后再重试。
## 99 种工具，简要介绍
| 领域 | 覆盖范围 |
|---|---|
| 布局基础 | 文档生命周期、深入文档读取、页面预览、页面/层/参考线、文本框架 + 线程与溢出报告、形状、色板、图像、变换 |
| 排版引擎 | 段落/字符/对象样式（插入 + 分组）、GREP 查找/替换与反向引用、主页面、表格（标题行、交替填充、单元格样式）、首字母大写、项目符号、基准线网格、文本包装、锚定对象 |
| 发布流程 | 目录、章节、超链接/书签/交叉引用、索引、书籍（.indb）、命名框架模板填充、数据合并、片段、打印 + 交互式 PDF、IDML、EPUB、每页图像导出、预检配置文件、印刷包装 |
| 协调 | 持久的操作序列、对齐/分布、多文档工具、跨文档 GREP 重置样式 |
询问 AI *"列出可用于处理 InDesign 的函数"* 以获取完整的清单。
## 故障排除
- **MCP 在 Claude 中启动失败** — 在 Claude 配置中添加 `uv` 的绝对路径。
- **插件无法连接** — 确保 InDesign 已启动并且代理服务器已启动。
如果按钮仍然显示“连接”，则代理服务器在端口 3001 上不可访问。
- **每个命令都报错“需要打开的 InDesign 文档”** — 首先打开或创建文档。
- **所有内容都超时** — 检查阻止 OS/InDesign 对话框（例如，导出后出现“选择应用程序”对话框）；关闭它会立即恢复。
仍然遇到问题？[打开问题](https://github.com/Rinellasky/indesign-mcp/issues)，附上您的
操作系统、InDesign 版本和任何错误。
## 源代码和致谢
本仓库分发打包的版本。已编译的 `.dxt` 和 `.ccx` 包含
完整的、未压缩的服务器（Python）和插件（JavaScript）代码。基于
[Mike Chambers 的 adb-mcp](https://github.com/mikechambers/adb-mcp) 概念验证 —
代理架构从那里开始；InDesign 集成从一个
工具桩扩展到完整的 99 工具套件。
在 [MIT License](LICENSE.md) 下发布。Adobe 和 InDesign 是 Adobe Inc. 的商标；本项目是非官方的，与 Adobe 无关联或获得其认可。
