Adobe MCP Server

Adobe MCP for macOS

Control Adobe Creative Cloud from AI agents via the Model Context Protocol

Quick Start • Features • Dashboard • Tools • Themes • Importers • Configuration

______________________________________________________________________

允许Claude（或任何兼容MCP的AI）驱动的MCP服务器 InDesign, Photoshop，以及 插画师 在macOS上，通过本机AppleScript桥使用ExtendScript。从Notion、Google Docs、Word或PDF导入内容，然后一次性生成专业排版的电子书、文档和创意资产。

快速开始

先决条件

安装

# Clone the repo
git clone https://github.com/YOUR_USERNAME/adobe-mcp.git
cd adobe-mcp

# Install with all optional dependencies
pip install -e ".[all,dev]"

或者只安装您需要的东西：

pip install -e "."                # Core (InDesign, Photoshop, Illustrator)
pip install -e ".[notion]"        # + Notion imports
pip install -e ".[google]"        # + Google Docs imports
pip install -e ".[dev]"           # + pytest for running tests

授予macOS权限

首次使用时，macOS将提示输入自动化权限：

系统设置→ 隐私和安全→ 自动化

授予您的终端应用程序（终端、iTerm、VS Code、Claude Desktop等）控制每个Adobe应用程序的权限。

联系克劳德

克劳德代码CLI --添加到您的项目 .mcp.json:

{
  "mcpServers": {
    "adobe-mcp-macos": {
      "command": "python",
      "args": ["-m", "adobe_mcp_macos"],
      "env": {}
    }
  }
}

克劳德桌面 --合并到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "adobe-mcp-macos": {
      "command": "python",
      "args": ["-m", "adobe_mcp_macos"],
      "env": {}
    }
  }
}

然后重启克劳德。Adobe工具将自动显示。

______________________________________________________________________

特性

一键式书籍创作

给克劳德一个简单的指示，比如 *“导入我的Notion页面并创建专业排版的电子书”* 它将：

1. 从Notion（或谷歌文档、Word、PDF）获取内容
2. 应用设计主题（排版、颜色、页面布局）
3. 使用章节开头符、TOC和流动文本创建InDesign文档
4. 导出两者a 可打印PDF （CMYK、裁剪痕迹、出血）和 数字PDF （RGB，优化）

Web仪表板

无需Claude即可创建电子书的独立浏览器UI：

adobe-mcp-dashboard
# → http://localhost:5050

仪表板提供：

• 内容导入 --粘贴Notion URL或上传DOCX/PDF
• 主题选择 --从内置主题中选择或创建自定义主题
• 实时进度 --SSE流媒体显示了书籍构建过程中的每个步骤
• 保存的导入 --重复使用以前导入的内容

多应用程序控制

三个Adobe应用程序中的40+MCP工具：

______________________________________________________________________

工具参考

共享工具

InDesign工具

图书创作（高级）

文档管理

布局和造型

内容

导航

图像

主题

出口

高级

Photoshop工具

插画工具

______________________________________________________________________

主题系统

主题控制着文档设计的各个方面——排版、颜色、页面尺寸、边距、母版页和导出设置。

内置主题

创建自定义主题

通过克劳德：

"Create a theme called 'Memoir' with Georgia body text,
large chapter numbers, and warm earth-tone colors"

通过仪表板： 从主题下拉列表中选择“自定义”并描述您的风格。

手动： 在中创建JSON文件 ~/.adobe-mcp/themes/:

{
  "name": "My Theme",
  "page": {
    "width_mm": 152.4,
    "height_mm": 228.6,
    "margins": { "top": 25.4, "bottom": 25.4, "inside": 19.05, "outside": 15.875 },
    "columns": 1
  },
  "typography": {
    "body": { "family": "Palatino", "font_style": "Regular", "size": 12, "leading": 18 },
    "h1": { "family": "Optima", "font_style": "Bold", "size": 28, "leading": 34 },
    "h2": { "family": "Optima", "font_style": "Regular", "size": 18, "leading": 24 }
  },
  "colors": {
    "body_text": "#1a1a1a",
    "heading": "#000000",
    "accent": "#4a7c59"
  }
}

主题使用Pydantic进行验证——缺少的字段将恢复为合理的默认值。

InDesign模板

主题可以参考 .indt InDesign模板文件，用于JSON无法表达的高级布局。将模板放置在 src/adobe_mcp_macos/themes/templates/.

______________________________________________________________________

内容导入器

将多个来源的内容导入到结构化格式中，以便创建书籍。

富文本支持

Notion导入程序保留源文档的格式：

• 加粗, *斜体*，以及其他内联样式
• 颜色注释
• 这些样式作为字符级别替代传递到InDesign输出

通用进口

这 id_import_to_book 工具是最简单的路径——提供任何一个源代码，并返回一个现成的BookManifest：

"Import my Notion page https://notion.so/My-Book-abc123
and create an ebook using the Zen theme"

______________________________________________________________________

配置

环境变量

将这些设置为 .env 在项目根目录中创建文件，或在MCP服务器配置中传递它们：

{
  "mcpServers": {
    "adobe-mcp-macos": {
      "command": "python",
      "args": ["-m", "adobe_mcp_macos"],
      "env": {
        "NOTION_API_TOKEN": "ntn_your_token_here"
      }
    }
  }
}

概念设置

1. 首选 notion.so/my集成
2. 创建新的内部集成
3. 复制令牌（以开头 ntn_)
4. 在Notion中，打开要导入的页面→ ⋯ → 连接 → 添加您的集成

谷歌文档设置

1. 在中创建服务帐户 谷歌云控制台
2. 启用Google Docs API
3. 下载JSON密钥文件
4. 使用服务帐户电子邮件地址共享您的谷歌文档
5. 集 GOOGLE_SERVICE_ACCOUNT_JSON 到密钥文件的路径

______________________________________________________________________

运行测试

# All unit tests (no Adobe apps needed)
pytest tests/ --ignore=tests/integration -v

# Integration tests (requires running Adobe apps)
pytest tests/integration/ -v

# Quick check
pytest tests/ -q

______________________________________________________________________

建筑

adobe-mcp-macos/
├── src/adobe_mcp_macos/
│   ├── server.py              # MCP server entry point (FastMCP)
│   ├── executor.py            # AppleScript bridge → ExtendScript execution
│   ├── tools/
│   │   ├── indesign.py        # InDesign MCP tools (high-level)
│   │   ├── indesign_jsx.py    # JSX code generators (low-level)
│   │   ├── photoshop.py       # Photoshop MCP tools
│   │   ├── illustrator.py     # Illustrator MCP tools
│   │   ├── shared.py          # Cross-app utilities
│   │   └── importers.py       # Content import tools
│   ├── importers/
│   │   ├── notion.py          # Notion API client
│   │   ├── google_docs.py     # Google Docs API client
│   │   ├── docx_parser.py     # Word document parser
│   │   ├── pdf_parser.py      # PDF parser (font-size heuristics)
│   │   └── rich_text.py       # Rich text markup handling
│   ├── themes/
│   │   ├── manager.py         # Theme loading, saving, listing
│   │   ├── validator.py       # Pydantic models for theme validation
│   │   ├── builtin/           # Built-in theme JSON files
│   │   └── templates/         # InDesign .indt template files
│   ├── models/                # Pydantic input models for all tools
│   └── dashboard/
│       ├── app.py             # Starlette web server
│       └── index.html         # Single-page dashboard UI
├── tests/                     # 250+ unit tests
├── docs/plans/                # Design documents
└── pyproject.toml

运作原理

Claude / Dashboard
        │
        ▼
   MCP Server (FastMCP)
        │
        ▼
   Tool Functions (Python)
        │
        ▼
   JSX Code Generators
        │
        ▼
   executor.py → osascript → AppleScript
        │
        ▼
   Adobe App (ExtendScript engine)

1. Claude调用MCP工具（例如。， id_create_book)
2. Python生成ExtendScript（JSX）代码
3. 执行器将JSX写入临时文件，并通过以下方式调用它 osascript
4. Adobe的ExtendScript引擎在应用程序内运行代码
5. 结果通过stdout返回Python

______________________________________________________________________

已知限制

• ExtendScript同步运行——非常长的操作可能会超时（默认60秒）
• 这 execute_jsx 工具在Adobe应用程序中运行任意代码；谨慎使用
• 自定义主题生成使用现有主题作为基础；编辑JSON以实现完全控制
• Premiere Pro和After Effects尚不支持
• 需要macOS（由于AppleScript依赖性，不支持Windows/Linux）

许可证

麻省理工学院