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 分