🌸 kirei-adobe-mcp

The definitive, unified, strictly-typed Model Context Protocol (MCP) server for Adobe Photoshop, Premiere Pro, After Effects, and Illustrator.

Designed for enterprise AI assistants (Claude Desktop, Cursor, Antigravity, Cline, Windsurf), kirei-adobe-mcp replaces brittle scripts with 62 deterministic tools, strict Zod contracts, cryptographic risk classification (R0–R4), Content-Addressed Storage (CAS), and visual verification.

📖 Application Guides & Documentation

⚡ Quickstart in 60 Seconds (Zero-Config)

You do not need to clone the repository or manually build the project. You can run kirei-adobe-mcp directly with npx:

1. Add to Your Favorite MCP Client

🤖 Claude Desktop

Add this entry to your configuration file (%APPDATA%\Claude\claude_desktop_config.json on Windows or ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "kirei-adobe": {
      "command": "npx",
      "args": ["-y", "kirei-adobe-mcp"]
    }
  }
}

💻 Cursor

Create or edit .cursor/mcp.json in your workspace or global Cursor settings:

{
  "mcpServers": {
    "kirei-adobe": {
      "command": "npx",
      "args": ["-y", "kirei-adobe-mcp"]
    }
  }
}

🚀 Antigravity / Gemini CLI

Add to ~/.gemini/antigravity-cli/mcp.json:

{
  "mcpServers": {
    "kirei-adobe": {
      "command": "npx",
      "args": ["-y", "kirei-adobe-mcp"]
    }
  }
}

🌊 Windsurf / Cascade

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "kirei-adobe": {
      "command": "npx",
      "args": ["-y", "kirei-adobe-mcp"]
    }
  }
}

🛠️ Cline / Roo Code (VS Code Extension)

Add to your Cline MCP settings:

{
  "mcpServers": {
    "kirei-adobe": {
      "command": "npx",
      "args": ["-y", "kirei-adobe-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Related MCP server: Premiere Pro Full MCP

🧙‍♂️ 1-Click Installation & Diagnostic CLI Wizard

kirei-adobe-mcp includes interactive built-in tools for seamless configuration:

# 1. Full diagnostic of system environment and detected Adobe CC applications
npx kirei-adobe-mcp doctor

# 2. Automatically configure detected MCP clients (Claude Desktop, Cursor, etc.)
npx kirei-adobe-mcp setup

# 3. Automatically copy extension panels/scripts to official Adobe folders
npx kirei-adobe-mcp install-plugins

Automated 1-Click Launchers

• Windows (Double-click or PowerShell):

  .\install.bat
  # or
  powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1

• macOS / Linux (Terminal):

  bash install.sh
  # or
  bash scripts/setup-macos.sh

🏗️ System Architecture

flowchart TD
  Client["MCP Client<br/>Claude · Cursor · Antigravity · Cline · Windsurf"] -->|"STDIO Gateway (JSON-RPC)"| Gateway["Gateway Server (MCP 2026)"]
  Gateway -.->|"Auto-bootstrap if inactive"| Daemon
  Gateway -->|"HMAC-SHA256 Loopback RPC"| Daemon["Loopback Bridge Daemon<br/>127.0.0.1:49152"]
  
  Daemon <--> PS["Photoshop<br/>(UXP Modal Panel)"]
  Daemon <--> PR["Premiere Pro<br/>(UXP / CEP Timeline Bridge)"]
  Daemon <--> AE["After Effects<br/>(ScriptUI / aerender CLI)"]
  Daemon <--> AI["Illustrator<br/>(JSX Engine / Pathfinder)"]
  
  Daemon --> CAS[("Artifact Store (CAS)<br/>artifact://sha256-...")]
  Daemon --> Sagas["Workflow Saga Engine<br/>Compensation & Rollback"]

🎯 The Front-Door Pattern (>80% Token Savings)

Instead of overloading the AI context window by publishing 62 individual tools simultaneously, kirei-adobe-mcp implements progressive discovery:

1. adobe.tools.discover: Query the internal operation registry by application, category, or risk.

2. adobe.tools.describe: Retrieve the exact JSON/Zod schemas only for required operations.

3. adobe.operations.plan: Compile and validate an immutable plan with risk estimation and planHash.

4. adobe.operations.execute: Execute approved operations idempotently with verifiable receipts.

🎨 Application Coverage

🛡️ Security & Risk Model (R0–R4)

🔧 Troubleshooting & FAQ

❓ MCP client reports BRIDGE_UNAVAILABLE: panel disconnected

• Resolution: Open the corresponding Adobe application (Photoshop, Premiere, etc.) and ensure the extension panel or script is loaded and showing green status (Connected).

❓ Extension signature error in Premiere CEP (PlayerDebugMode)

• Resolution: Run npx kirei-adobe-mcp install-plugins (or install.bat) to automatically configure CSXS debug mode in the Windows Registry or macOS defaults.

❓ Conflict on port 49152

• Resolution: If another service occupies port 49152, set the environment variable in your MCP client configuration:

  "env": {
    "ADOBE_MCP_DAEMON_PORT": "50000"
  }

🛠️ Local Development & Contributing

To contribute to the monorepo:

git clone https://github.com/hyukudan/kirei-adobe-mcp.git
cd kirei-adobe-mcp
corepack enable
pnpm install
pnpm build
pnpm turbo run test typecheck

🤝 Multi-Model Collaborative Engineering

This project was architected and built through advanced collaborative engineering, leveraging deep reasoning and multimodal capabilities from Google DeepMind, Anthropic, and OpenAI, alongside official Adobe Creative Cloud and Model Context Protocol specifications.

📄 License

Distributed under the MIT License. See LICENSE for details.