内容
# InDesign MCP 服务器 — 跨平台（macOS 和 Windows）
用于 **Adobe InDesign 自动化** 的综合 **模型上下文协议（MCP）服务器**，包含 **35+ 个专业工具**。该服务器使 Claude 等 AI 助手可以直接控制 Adobe InDesign，自动化复杂的出版工作流程、文档创建和专业布局任务。
> **跨平台分支** 的 [lucdesign/indesign-mcp-server](https://github.com/lucdesign/indesign-mcp-server) （仅限 macOS，AppleScript）。该分支通过 COM/VBScript 添加了 **原生 Windows 传输** （`CreateObject("InDesign.Application")` + `DoScript`），并根据 `process.platform` 自动选择正确的传输。所有 36 个工具保持不变 — ExtendScript 层在两个平台上完全相同。有关端口的详细信息，请参见 [WINDOWS.md](WINDOWS.md)。
## 🚀 功能
### 📄 **文档管理**
- 创建、打开、保存和关闭文档，具有高级选项
- 支持所有标准格式（A4、A5、Letter、Legal、自定义）
- 对开页、出血、标志和边距配置
- 多页文档处理
### ✍️ **文本和排版**
- 高级文本框架创建和编辑
- 字符和段落样式管理
- 支持 GREP 的查找/替换
- 专业排版控制（行距、跟踪、光学边距对齐）
### 🎨 **图形和布局**
- 支持多种适应选项的图片放置
- 形状创建（矩形、椭圆，带样式）
- 图层管理和组织
- 颜色样本创建和管理（CMYK、RGB、Spot 颜色）
### 📊 **表格和数据**
- 表格创建和数据填充
- 支持页眉和页脚
- CSV 数据集成能力
### 📤 **导出和生产**
- 专业 PDF 导出，带有预设
- 多格式图像导出（PNG、JPEG、TIFF）
- 数字出版的 EPUB 导出
- 印刷生产的包装
- 预检检查
### 🔧 **自动化和脚本**
- 数据合并操作
- 自定义 ExtendScript 执行
- 批处理能力
- 专业出版工作流程
## 📋 先决条件
- **Adobe InDesign** （已在 2024–2026 版本中测试）
- **macOS** （AppleScript 传输） **或 Windows** （COM/VBScript 传输 — 此分支）
- **Node.js 18+**
- **MCP 兼容客户端** （Claude Desktop、Claude Code、Cursor…）
### 可选环境变量
- `INDESIGN_APP_NAME` （macOS）— AppleScript 的应用程序名称，默认为 `Adobe InDesign 2025`
- `INDESIGN_PROGID` （Windows）— COM ProgID，默认为 `InDesign.Application` （版本无关；按顺序回退到 `InDesign.Application.2026/2025/2024`）
## 🛠️ 安装
### 1. 克隆仓库
```bash
git clone https://github.com/Tlechanteur/indesign-mcp-server-windows.git
cd indesign-mcp-server-windows
```
### 2. 安装依赖项
```bash
npm install
```
### 3. 配置 MCP 客户端
将服务器添加到您的 MCP 客户端配置中（例如，Claude Desktop）：
**claude_desktop_config.json:**
```json
{
"mcpServers": {
"indesign": {
"command": "node",
"args": ["/path/to/indesign-mcp-server/index.js"],
"env": {}
}
}
}
```
### 4. 启动 Adobe InDesign
确保 Adobe InDesign 在使用 MCP 服务器之前已运行。
## 🎯 快速入门
### 创建专业文档
```javascript
// 创建一个带有对开页的 A4 文档
create_document({
preset: "A4",
orientation: "Portrait",
pages: 4,
facingPages: true,
marginTop: 20,
marginBottom: 20,
marginLeft: 20,
marginRight: 20
})
```
### 添加格式化文本
```javascript
// 创建一个带有专业排版的文本框架
create_text_frame({
content: "InDesign MCP 的专业出版",
x: 20,
y: 20,
width: 170,
height: 50,
fontSize: 18,
fontFamily: "Helvetica Neue",
fontStyle: "Bold",
alignment: "LEFT_ALIGN"
})
```
### 创建和应用样式
```javascript
// 创建一个字符样式
create_character_style({
name: "强调",
fontFamily: "Helvetica Neue",
fontStyle: "Italic",
textColor: "Red"
})
// 应用于特定文本
find_replace_text({
findText: "重要",
replaceText: "重要",
applyCharacterStyle: "强调"
})
```
### 导出专业 PDF
```javascript
export_pdf({
filePath: "/path/to/output.pdf",
preset: "HighQualityPrint",
includeBleed: true,
colorProfile: "ISO Coated v2"
})
```
## 🛠️ 可用工具
### **文档管理（5 个工具）**
- `get_document_info` - 文档信息和统计数据
- `create_document` - 高级文档创建
- `open_document` - 打开现有文档
- `save_document` - 保存时可选新路径
- `close_document` - 关闭时可选保存选项
### **页面管理（4 个工具）**
- `add_page` - 添加页面，控制位置
- `delete_page` - 安全删除页面
- `duplicate_page` - 复制页面及其内容
- `navigate_to_page` - 页面导航
### **文本管理（3 个工具）**
- `create_text_frame` - 高级文本框架创建
- `edit_text_frame` - 修改现有框架
- `find_replace_text` - 搜索和替换，支持 GREP
### **图形管理（3 个工具）**
- `place_image` - 图片放置，适应选项
- `create_rectangle` - 创建矩形，带样式
- `create_ellipse` - 创建椭圆，带样式
### **样式管理（4 个工具）**
- `create_paragraph_style` - 段落样式创建
- `create_character_style` - 字符样式创建
- `apply_paragraph_style` - 应用段落样式
- `list_styles` - 列出所有可用样式
### **颜色管理（3 个工具）**
- `create_color_swatch` - 创建 CMYK/RGB/Spot 颜色
- `list_color_swatches` - 列出可用颜色
- `apply_color` - 应用颜色到对象
### **表格管理（2 个工具）**
- `create_table` - 表格创建，带页眉/页脚
- `populate_table` - 填充表格数据
### **图层管理（3 个工具）**
- `create_layer` - 创建新图层
- `set_active_layer` - 切换活动图层
- `list_layers` - 列出所有图层
### **导出和生产（4 个工具）**
- `export_pdf` - 专业 PDF 导出
- `export_images` - 多格式图像导出
- `export_epub` - 数字出版导出
- `package_document` - 印刷生产包装
### **自动化和实用工具（4 个工具）**
- `execute_indesign_code` - 自定义 ExtendScript 执行
- `preflight_document` - 质量检查
- `view_document` - 文档可视化
- `data_merge` - 自动数据集成
## 💡 用例
### **自动化出版**
- 从数据生成新闻通讯、宣传册和报告
- 批量处理多个文档
- 文档系列的样式一致性
### **数据驱动文档**
- 个人化材料的邮件合并
- 从数据库生成的目录
- 带有动态内容的财务报告
### **专业工作流程**
- 基于模板的文档创建
- 品牌合规自动化
- 印刷生产准备
### **教育材料**
- 自动教科书布局
- 练习表生成
- 多语言文档变体
## 🔧 高级配置
### 自定义 ExtendScript 集成
```javascript
execute_indesign_code({
code: `
// 自定义 InDesign 脚本
var doc = app.activeDocument;
// 您的自定义自动化逻辑在此
`
})
```
### 批处理示例
```javascript
// 处理多个文件
const files = ["doc1.indd", "doc2.indd", "doc3.indd"];
for (const file of files) {
await open_document({ filePath: file });
await export_pdf({
filePath: file.replace('.indd', '.pdf'),
preset: 'HighQualityPrint'
});
await close_document({ save: false });
}
```
## 🐛 故障排除
### 常见问题
**"找不到 Adobe InDesign"**
- 确保 InDesign 已安装并正在运行
- macOS：在系统偏好设置中检查 AppleScript 权限
- Windows：COM 桥启动 InDesign（如果需要），但先启动它会更快、更可靠。如果您同时运行多个 InDesign 版本，请设置 `INDESIGN_PROGID` （例如 `InDesign.Application.2026`）
**"脚本执行失败"**
- 验证 Adobe InDesign 是否是活动应用程序
- 在控制台中检查文档特定错误
**"找不到工具"**
- 在配置更改后重启 MCP 客户端
- 使用 `node index.js` 验证服务器是否正在运行
### 调试模式
```bash
node --inspect index.js
```
## 🤝 贡献
1. **Fork** 仓库
2. **创建** 功能分支 (`git checkout -b feature/AmazingFeature`)
3. **提交** 您的更改 (`git commit -m 'Add some AmazingFeature'`)
4. **推送** 到分支 (`git push origin feature/AmazingFeature`)
5. **打开** 拉取请求
## 📝 许可证
该项目在 **MIT 许可证** 下许可 — 参见 [LICENSE](LICENSE) 文件了解详情。
## 🙏 致谢
- **Anthropic** 适用于模型上下文协议
- **Adobe** 适用于 InDesign ExtendScript API
- **MCP 社区** 适用于工具和灵感
## 📞 支持
- **问题**: [GitHub 问题](https://github.com/Tlechanteur/indesign-mcp-server-windows/issues)
- **原始 macOS 项目**: [lucdesign/indesign-mcp-server](https://github.com/lucdesign/indesign-mcp-server)
---
**为出版社区制作 ❤️**
*使用 AI 自动化转换您的 InDesign 工作流程*
