mcp-indesign

English | Português | Español

直接从 Codex、Claude、OpenCode 及其他 MCP 客户端控制 Adobe InDesign。

安装 · 工具 · 安全 · 开发

InDesign MCP 是一个通过 COM 和 ExtendScript 在 Windows 上自动化 Adobe InDesign 的 Model Context Protocol 服务器。它使 AI 助手能够使用结构化工具检查文档、编辑内容并执行导出。

✨ 亮点

• 19 个工具，可用于编辑、检查和导出。

• npm 安装，无需 InDesign 插件或启动脚本。

• 与 Codex、Claude Desktop、Claude Code 和 OpenCode 原生集成。

• 通过 stdio 本地执行；您的文档不会通过 MCP 发送。

• 默认安全，禁用任意 JSX 执行。

Related MCP server: indesign-mcp-server

📋 系统要求

• Windows 10 或 11

• Adobe InDesign 2024 或更高版本

• Node.js 18 或更高版本

• PowerShell 5.1 或更高版本

使用服务器时，InDesign 必须处于打开状态。无需启动脚本或防火墙配置。

📦 npm 安装

您无需克隆仓库或全局安装该包。将您的 MCP 客户端配置为运行：

npx -y mcp-indesign

Codex

将以下内容添加到 ~/.codex/config.toml：

[mcp_servers.indesign]
command = "npx"
args = ["-y", "mcp-indesign"]
startup_timeout_sec = 30

[mcp_servers.indesign.env]
INDESIGN_MCP_LANGUAGE = "en"

Claude Desktop 或 Claude Code

{
  "mcpServers": {
    "indesign": {
      "command": "npx",
      "args": ["-y", "mcp-indesign"],
      "env": { "INDESIGN_MCP_LANGUAGE": "en" }
    }
  }
}

OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "indesign": {
      "type": "local",
      "command": ["npx", "-y", "mcp-indesign"],
      "environment": { "INDESIGN_MCP_LANGUAGE": "en" },
      "enabled": true
    }
  }
}

重启客户端，打开 InDesign，然后运行 check_connection。

🧰 工具

🔐 安全

运行时默认使用英语。如有需要，可在 MCP 环境中设置界面语言：

INDESIGN_MCP_LANGUAGE=en     # English
INDESIGN_MCP_LANGUAGE=pt-BR  # Portuguese (pt and pt-PT are also accepted)
INDESIGN_MCP_LANGUAGE=es     # Spanish

run_jsx 允许任意 ExtendScript 执行，默认处于禁用状态。仅在受信任的环境中启用它：

INDESIGN_MCP_ENABLE_RUN_JSX=1

要使用外部安装的 BatchExportProfessional.jsx：

INDESIGN_MCP_BATCH_SCRIPT=C:\path\BatchExportProfessional.jsx

🛠️ 开发

git clone https://github.com/SanNw/Indesign-MCP.git
cd Indesign-MCP
npm install
npm test

该测试会启动服务器，验证全部 19 个工具，并确认 run_jsx 默认仍处于阻止状态。

🩺 故障排除

• 在使用其他工具之前，先运行 check_connection。

• 确认 InDesign 已在同一 Windows 会话中打开。

• 更改配置后，重启 MCP 客户端。

• 导出预设因 InDesign 版本和语言而异。

⚠️ 限制

• 0.1.x 系列仅支持 Windows。

• 操作可能会修改打开的文档，但不会自动保存。

• 兼容性已通过 InDesign 2025 直接验证；其他版本应由社区进行测试。

📄 许可证

MIT

致力于拉近人工智能与编辑设计的距离。