Idml Mcp

io.github.jimprivate由 GitHub 账号 jimprivate 发布v0.1.1更新于 Oct 27, 2026

MCP server for AI agents to read and safely edit Adobe InDesign IDML files. No InDesign required.

已验证STDIO仅桌面文件与存储媒体与设计

概览

AI 生成的概览

本地 MCP 服务器,让 AI 助手在无需安装 InDesign 的情况下读取、汇总并安全编辑 Adobe InDesign 的 IDML 文件。

可以做什么
  • 将 IDML 包汇总为页面、框架、故事、图片链接和样式
  • 读取单个故事的纯文本及带索引和样式的文本片段
  • 替换某个文本片段的内容,同时保持版面和 XML 逐字节不变
  • 将图片链接指向另一个文件,而不改动几何位置
适用场景
适用于模板化出版、本地化和代理流程:需要读取设计版面并对 IDML 文件做针对性的文字或图片更新,而所在机器或 CI 环境没有 Adobe InDesign。
运行要求
以本地 stdio 进程运行,需要 Node.js(npm 包 idml-mcp);README 通过将命令指向构建后的 server.js 文件来配置。未声明任何认证、环境变量或请求头。仅限桌面端。
安装前请注意
它会写入 IDML 文件:替换文本和重新链接图片会修改文档内容,建议在副本上操作并保留备份。README 声称其余内容逐字节保持不变,但这只是提供方自己的说法。不要求任何凭据或网络访问。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Idml Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

idmlkit

The AI-native toolkit for Adobe InDesign files (IDML) — parse, summarize, and safely write back. No InDesign required.

AI tools have transformed how we write code and build web pages, but print and layout designers have largely been left out: the InDesign ecosystem has no AI-ready open interface. Existing InDesign MCP servers all remote-control a running InDesign instance — which means a license, a desktop, and an open app for every operation.

idmlkit takes the other road: it works directly on .idml files (InDesign's open, XML-based interchange format). That means it runs anywhere Node.js runs — servers, CI pipelines, Linux, a designer's laptop — with nothing from Adobe installed.

JSON data in ──► idmlkit ──► perfectly laid-out IDML out ──► open in InDesign / print

Design philosophy: the AI never touches the XML

LLMs are great at understanding a document and deciding what should change, and terrible at hand-editing 5,000 lines of layout XML without breaking it. So idmlkit splits the work:

  • Deterministic code parses the package and produces a compact, LLM-friendly summary (pages, frames, stories as indexed text runs, image links, styles) — a few hundred tokens instead of megabytes of XML.
  • Write-back is surgical: replacing a text run or relinking an image rewrites only that one element via targeted string surgery. Everything else — geometry, styles, the XML formatting itself — is preserved byte-for-byte (enforced by tests). The AI physically cannot corrupt your layout.

Validated against real InDesign 2025 exports: on Adobe's official Flex Layout sample (14.5 MB, with a single 20 MB spread), summarize runs in under half a second and a text edit changes exactly one zip entry — every other entry verified byte-identical by CRC.

Packages

PackageWhat it is
idmlkitCore library + CLI: open, summarize, safe text/image write-back
idml-mcpMCP server exposing those abilities to Claude and any MCP-capable agent

Quick start

sh
npm installnpm run buildnode scripts/make-sample-idml.mjs   # generates examples/sample.idml

CLI

sh
$ node packages/idmlkit/dist/cli.js summary examples/sample.idmlPages: 1  Spreads: 1Story u123 (11 words, 2 runs): Spring Catalog 2026 Fresh arrivals for the new season…Image link u202: file:/images/hero.jpgParagraph styles: $ID/NormalParagraphStyle, Headline, Body
$ node packages/idmlkit/dist/cli.js set-text examples/sample.idml u123 0 "Summer Sale 2026" -o out.idml$ node packages/idmlkit/dist/cli.js relink out.idml u202 "file:/images/summer.jpg"

MCP server (Claude Code / Claude Desktop)

json
{  "mcpServers": {    "idml": {      "command": "node",      "args": ["<repo>/packages/idml-mcp/dist/server.js"]    }  }}

Then ask Claude things like "Summarize catalog.idml and replace every 2025 date with 2026" — it will use these tools:

ToolPurpose
idml_summarizeStructured summary of pages, frames, stories, images, styles
idml_get_storyOne story's plain text + indexed runs with styles
idml_set_textReplace one run's text (layout untouched, byte-for-byte)
idml_relink_imagePoint an image link at a new file (geometry untouched)

Library

ts
import { IdmlDocument, summarizeDocument, setStoryRunText } from "idmlkit";
const doc = await IdmlDocument.open("catalog.idml");console.log(summarizeDocument(doc));      // LLM-friendly JSONsetStoryRunText(doc, "u123", 0, "New headline");await doc.save("catalog-updated.idml");

Use cases

  • Database publishing: fill a designed template with product data — thousands of catalog pages, price lists, or menus without opening InDesign once.
  • Localization: extract every text run with its styles, translate, write back safely.
  • Agent workflows: let Claude read a layout, reason about its content, and apply text/image updates as part of a larger pipeline.

Roadmap

  • Read IDML packages, LLM-friendly summaries
  • Safe text run replacement and image relinking
  • MCP server (stdio)
  • Page → frame mapping with geometry (which frame is where)
  • Template fill: apply a JSON data object to a tagged template in one call
  • Story-level structured diff (what changed between two IDML files)
  • Overflow heuristics (warn when new text likely won't fit its frame)
  • Real-world IDML corpus tests (CC 2018–2026 exports)

Development

sh
npm installnpm run build     # tsc project referencesnpm test          # vitest — includes byte-for-byte preservation tests

License

MIT. Not affiliated with or endorsed by Adobe. "Adobe" and "InDesign" are trademarks of Adobe Inc., used here only to describe compatibility.

来源:README.md,提交 0d781d4

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分