[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-mikechambers--adb-mcp":3,"tool-mikechambers--adb-mcp":62},[4,18,26,36,46,54],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",160411,2,"2026-04-18T23:33:24",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":42,"last_commit_at":43,"category_tags":44,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,45],"插件",{"id":47,"name":48,"github_repo":49,"description_zh":50,"stars":51,"difficulty_score":32,"last_commit_at":52,"category_tags":53,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",109154,"2026-04-18T11:18:24",[14,15,13],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":32,"last_commit_at":60,"category_tags":61,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[45,13,15,14],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":68,"readme_en":69,"readme_zh":70,"quickstart_zh":71,"use_case_zh":72,"hero_image_url":73,"owner_login":74,"owner_name":75,"owner_avatar_url":76,"owner_bio":66,"owner_company":66,"owner_location":66,"owner_email":77,"owner_twitter":78,"owner_website":79,"owner_url":80,"languages":81,"stars":102,"forks":103,"last_commit_at":104,"license":105,"difficulty_score":106,"env_os":107,"env_gpu":108,"env_ram":108,"env_deps":109,"category_tags":123,"github_topics":66,"view_count":32,"oss_zip_url":66,"oss_zip_packed_at":66,"status":17,"created_at":124,"updated_at":125,"faqs":126,"releases":137},9427,"mikechambers\u002Fadb-mcp","adb-mcp",null,"adb-mcp 是一个开源概念验证项目，旨在通过 MCP 协议让人工智能直接操控 Adobe Photoshop 和 Premiere Pro 等专业创意软件。它解决了传统 AI 无法深度介入桌面级设计工具工作流的痛点，让用户能用自然语言对话来完成复杂的编辑任务，例如让 AI 一步步指导新手操作、自动生成特定风格的社交媒体图片、批量规范图层命名，甚至自动创建包含素材与特效的 Premiere 剪辑工程。\n\n这款工具特别适合希望提升创作效率的设计师、视频编辑人员，以及想要探索 AI 在创意软件中应用边界的开发者和技术爱好者。即使是对软件操作不熟悉的普通用户，也能借助它轻松实现专业效果。\n\n其核心技术亮点在于构建了一套独特的通信架构：由 MCP 服务器作为 AI 接口，通过 Node.js 命令代理服务器中转，最终驱动安装在 Adobe 软件内的 UXP 插件执行具体指令。这种设计巧妙绕过了 Adobe 插件 API 的网络监听限制，实现了大模型与本地创意软件的无缝连接。目前该项目已在 Claude Desktop 和 OpenAI Agent SDK 上得到验证，为未来更多 Adobe ","adb-mcp 是一个开源概念验证项目，旨在通过 MCP 协议让人工智能直接操控 Adobe Photoshop 和 Premiere Pro 等专业创意软件。它解决了传统 AI 无法深度介入桌面级设计工具工作流的痛点，让用户能用自然语言对话来完成复杂的编辑任务，例如让 AI 一步步指导新手操作、自动生成特定风格的社交媒体图片、批量规范图层命名，甚至自动创建包含素材与特效的 Premiere 剪辑工程。\n\n这款工具特别适合希望提升创作效率的设计师、视频编辑人员，以及想要探索 AI 在创意软件中应用边界的开发者和技术爱好者。即使是对软件操作不熟悉的普通用户，也能借助它轻松实现专业效果。\n\n其核心技术亮点在于构建了一套独特的通信架构：由 MCP 服务器作为 AI 接口，通过 Node.js 命令代理服务器中转，最终驱动安装在 Adobe 软件内的 UXP 插件执行具体指令。这种设计巧妙绕过了 Adobe 插件 API 的网络监听限制，实现了大模型与本地创意软件的无缝连接。目前该项目已在 Claude Desktop 和 OpenAI Agent SDK 上得到验证，为未来更多 Adobe 应用的智能化控制提供了可行的技术路径。","# adb-mcp\n\nadb-mcp is a proof of concept project to enabled AI control of Adobe tools (Adobe Photoshop and Adobe Premiere) by providing an interface to LLMs via the MCP protocol.\n\nThe project is not endorsed by nor supported by Adobe.\n\nIt has been tested with Claude desktop (Mac and Windows) from Anthropic, as well as the OpenAI Agent SDK, and allows AI clients to control Adobe Photoshop and Adobe Premiere. Theoretically, it should work with any AI App \u002F LLM that supports the MCP protocol, and is built in a way to support multiple Adobe applications.\n\nExample use cases include:\n\n-   Giving Claude step by step instruction on what to do in Photoshop, providing a conversational based interface (particularly useful if you are new to Photoshop).\n-   Giving Claude a task (create an instagram post that looks like a Polariod image, create a double exposure) and letting it create it from start to finish to use as a template.\n-   Asking Claude to generate custom Photoshop tutorials for you, by creating an example file, then step by step instructions on how to recreate.\n-   As a Photoshop utility tool (have Claude rename all of your layers into a consistent format)\n-   Have Claude create new Premiere projects pre-populations with clips, transitions, effects and Audio\n\n[View Video Examples](https:\u002F\u002Fwww.youtube.com\u002Fplaylist?list=PLrZcuHfRluqt5JQiKzMWefUb0Xumb7MkI)\n\nThe Premiere agent is a bit more limited in functionality compared to the Photoshop agent, due to current limitations of the Premiere plugin API.\n\n## How it works\n\nThe proof of concept works by providing:\n\n-   A MCP Server that provides an interface to functionality within Adobe Photoshop to the AI \u002F LLM\n-   A Node based command proxy server that sits between the MCP server and Adobe app plugins\n-   An Adobe app (Photoshop and Premiere) plugin that listens for commands, and drives the programs\n\n**AI** \u003C-> **MCP Server** \u003C-> **Command Proxy Server** \u003C-> **Photoshop \u002F Premiere UXP Plugin** \u003C-> **Photoshop \u002F Premiere**\n\nThe proxy server is required because the public facing API for UXP Based JavaScript plugin does not allow it to listen on a socket connection (as a server) for the MCP Server to connect to (it can only connect to a socket as a client).\n\n## Requirements\n\nIn order to run this, the following is required:\n\n-   AI LLM with support for MCP Protocol (tested with Claude desktop on Mac & Windows, and OpenAI Agent SDK)\n-   Python 3, which is used to run the MCP server provided with this project\n-   NodeJS, used to provide a proxy between the MCP server and Photoshop\n-   Adobe UXP Developer tool (available via Creative Cloud) used to install and debug the Photoshop \u002F Premiere plugin used to connect to the proxy\n-   Adobe Photoshop (26.0 or greater) with the MCP Plugin installed or Adobe Premiere Beta (25.3 Build 46 or greater)\n\n\n## Installation\n\nThis guide assumes you're using Claude Desktop. Other MCP-compatible AI applications should work similarly.\n\n\n### Download Source Code\nClone or download the source code from the [main project page](https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fadb-mcp).\n\n### Install Claude Desktop\n1. Download and install [Claude Desktop](https:\u002F\u002Fclaude.ai\u002Fdownload)\n2. Launch Claude Desktop to verify it works\n\nNote, you can use any client \u002F code that supports MCP, just follow its instructions for how to configure.\n\n### Install MCP for Development\nNavigate to the project directory and run:\n\n#### Photoshop\n```bash\nuv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with numpy ps-mcp.py\n```\n\n#### Premiere Pro\n```bash\nuv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow pr-mcp.py\n```\n\n#### InDesign\n```bash\nuv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow id-mcp.py\n```\n\n#### AfterEffects\n```bash\nuv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow ae-mcp.py\n```\n\n#### Illustrator\n```bash\nuv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow ai-mcp.py\n```\n\nRestart Claude Desktop after installation.\n\n### Set Up Proxy Server\n\n#### Using Prebuilt Executables (Recommended)\n\n1. Download the appropriate executable for your platform from the latest [release](https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fadb-mcp\u002Freleases) (files named like `adb-proxy-socket-macos-x64.zip` (Intel), `adb-proxy-socket-macos-arm64.zip` (Silicon), or `adb-proxy-socket-win-x64.exe.zip`).\n2. Unzip the executable.\n3. Double click or run from the console \u002F terminal\n\n#### Running from Source\n\n1. Navigate to the adb-proxy-socket directory\n2. Run `node proxy.js`\n\nYou should see a message like:  \n   `Photoshop MCP Command proxy server running on ws:\u002F\u002Flocalhost:3001`\n\n**Keep this running** — the proxy server must stay active for Claude to communicate with Adobe plugins.\n\n### Install Plugins\n\n#### Photoshop, Premiere Pro, InDesign (UXP)\n\n1. Launch **UXP Developer Tools** from Creative Cloud\n2. Enable developer mode when prompted\n3. Select **File > Add Plugin**\n4. Navigate to the appropriate directory and select **manifest.json**:\n   - **Photoshop**: `uxp\u002Fps\u002Fmanifest.json`\n   - **Premiere Pro**: `uxp\u002Fpr\u002Fmanifest.json`\n   - **InDesign**: `uxp\u002Fid\u002Fmanifest.json`\n5. Click **Load**\n6. In your Adobe application, open the plugin panel and click **Connect**\n\n##### Enable Developer Mode in Photoshop\n\n**For Photoshop:**\n1. Launch Photoshop (2025\u002F26.0 or greater)\n2. Go to **Settings > Plugins** and check **\"Enable Developer Mode\"**\n3. Restart Photoshop\n\n#### AfterEffects, Illustrator (CEP)\n\n##### Mac\n1. Make sure the following directory exists (if it doesn't then create the directories)\n   `\u002FUsers\u002FUSERNAME\u002FLibrary\u002FApplication Support\u002FAdobe\u002FCEP\u002Fextensions`\n\n2. Navigate to the extensions directory and create a symlink that points to the AfterEffect \u002F Illustrator plugin in the CEP directory.\n```bash\ncd \u002FUsers\u002FUSERNAME\u002FLibrary\u002FApplication Support\u002FAdobe\u002FCEP\u002Fextensions\nln -s \u002FUsers\u002FUSERNAME\u002Fsrc\u002Fadb-mcp\u002Fcep\u002Fcom.mikechambers.ae com.mikechambers.ae\n```\nor\n```bash\ncd \u002FUsers\u002FUSERNAME\u002FLibrary\u002FApplication Support\u002FAdobe\u002FCEP\u002Fextensions\nln -s \u002FUsers\u002FUSERNAME\u002Fsrc\u002Fadb-mcp\u002Fcep\u002Fcom.mikechambers.ai com.mikechambers.ai\n```\n\n##### Windows\n1. Make sure the following directory exists (if it doesn't then create the directories)\n   `C:\\Users\\USERNAME\\AppData\\Roaming\\Adobe\\CEP\\extensions`\n\n2. Open Command Prompt as Administrator (or enable Developer Mode in Windows Settings)\n\n3. Create a junction or symbolic link that points to the AfterEffect \u002F Illustrator plugin in the CEP directory:\n```cmd\nmklink \u002FD \"C:\\Users\\USERNAME\\AppData\\Roaming\\Adobe\\CEP\\extensions\\com.mikechambers.ae\" \"C:\\Users\\USERNAME\\src\\adb-mcp\\cep\\com.mikechambers.ae\"\n```\nor\n```cmd\nmklink \u002FD \"C:\\Users\\USERNAME\\AppData\\Roaming\\Adobe\\CEP\\extensions\\com.mikechambers.ai\" \"C:\\Users\\USERNAME\\src\\adb-mcp\\cep\\com.mikechambers.ai\"\n```\n\nNote if you don't want to symlink, you can copy com.mikechambers.ae \u002F com.mikechambers.ao into the CEP directory.\n\n### Using Claude with Adobe Apps\n\nLaunch the following:\n\n1. Claude Desktop\n2. adb-proxy-socket node server\n3. Launch Photoshop, Premiere, InDesign, AfterEffects, Illustrator\n\n_TIP: Create a project for Photoshop \u002F Premiere Pro in Claude and pre-load any app specific instructions in its Project knowledge._\n\n#### Photoshop\n1. Launch UXP Developer Tool and click the Load button for _Photoshop MCP Agent_\n2. In Photoshop, if the MCP Agent panel is not open, open _Plugins > Photoshop MCP Agent > Photoshop MCP Agent_\n3. Click connect in the agent panel in Photoshop\n\nNow you can switch over the Claude desktop. Before you start a session, you should load the instructions resource which will provide guidance and info the Claude by clicking the socket icon (Attach from MCP) and then _Choose an Integration_ > _Adobe Photoshop_ > _config:\u002F\u002Fget_instructions_.\n\n\n\n#### Premiere\n1. Launch UXP Developer Tool and click the Load button for _Premiere MCP Agent_\n2. In Premiere, if the MCP Agent panel is not open, open _Window > UXP Plugins > Premiere MCP Agent > Premiere MCP Agent_\n3. Click connect in the agent panel in Photoshop\n\n#### InDesign\n1. Launch UXP Developer Tool and click the Load button for InDesitn MCP Agent_\n2. In InDesign, if the MCP Agent panel is not open, open _Plugins > InDesign MCP Agent > InDesign MCP Agent_\n3. Click connect in the agent panel in Photoshop\n\n#### AfterEffects\n1. _Window > Extensions > Illustrator MCP Agent_\n\n#### Illustrator\n\n1. Open a file (the plugin won't launch unless a file is open)\n2. _Window > Extensions > Illustrator MCP Agent_\n\n\nNote, you must reload the plugin via the UXP Developer app every time you restart Photoshop, Premiere and InDesign.\n\n### Setting up session\n\nIn the chat input field, click the \"+\" button. From there click \"Add from Adobe Photoshop \u002F Premiere\" then select *config:\u002F\u002Fget_instructions*. This will load the instructions into the prompt. Submit that to Claude and once it processes it, you are ready to go.\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmikechambers_adb-mcp_readme_040a4ba7fc78.png\" width=\"300\">\n\nThis will help reduce errors when the AI is using the app.\n\n\n### Prompting\n\nAt anytime, you can ask the following:\n\n```\nCan you list what apis \u002F functions are available for working with Photoshop \u002F Premiere?\n```\n\nand it will list out all of the functionality available.\n\nWhen prompting, you do not need to reference the APIs, just use natural language to give instructions.\n\nFor example:\n\n```\nCreate a new Photoshop file with a blue background, that is 1080 width by 720 height at 300 dpi\n```\n\n```\nCreate a new Photoshop file for an instagram post\n```\n\n```\nCreate a double exposure image in Photoshop of a woman and a forest\n```\n\n```\nGenerate an image of a forest, and then add a clipping mask to only show the center in a circle\n```\n```\nMake something cool with photoshop\n```\n\n```\nAdd cross fade transitions between all of the clips on the timeline in Premiere\n```\n\n\n### Tips\n\n#### General\n* When asking AI to view the content in Photoshop \u002F Premiere Pro, you can see the image returned in the Tool Call item in the chat. It will appear once the entire response has been added to the chat.\n* When prompting, ask the AI to think about and check its work.\n* The more you guide it (i.e. \"consider using clipping masks\") the better the results\n* The more advanced the model, or the more resources given to the model the better and more creative the AI is.\n* As a general rule, don't make changes in the Adobe Apps while the AI is doing work. If you do make changes, make sure to tell the AI about it.\n* The AI will learn from its mistakes, but will lose its memory once you start a new chat. You can guide it to do things in a different way, and then ask it to start over and it should follow the new approach.\n\nThe AI currently has access to a subset of Photoshop \u002F Premiere \u002F InDesign \u002F Illustrator \u002F AfterEffects functionality. In general, the approach has been to provide lower level tools to give the AI the basics to do more complex stuff.\n\nNote, for AfterEffects and Illustrator, there is a low level Extend Script API that will let the LLM run any arbitrary extend script (which allows it to do just about anything).\n\nThe Photoshop plugin has more functionality that Premiere.\n\nBy default, the AI cannot access files directly, although if you install the [Claude File System MCP server](https:\u002F\u002Fwww.claudemcp.com\u002Fservers\u002Ffilesystem) it can access, and load files into Photoshop \u002F Premiere (open files and embed images).\n\n#### Photoshop\n\n* You can ask the AI to look at the content of the Photoshop file and it should be able to then see the output.\n* The AI currently has issue sizing and positioning text correctly, so giving it guidelines on font sizes to use will help, as well as telling it to align the text relative to the canvas.\n* The AI has access to all of the Postscript fonts on the system. If you want to specify a font, you must use its Postscript name (you may be able to ask the AI for it).\n* You can ask the AI for suggestions. It comes up with really useful ideas \u002F feedback sometimes.\n\n#### Premiere\n\n* Currently the plugin assumes you are just working with a single sequence.\n* Pair the Premiere Pro MCP with the [media-utils-mcp](https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fmedia-utils-mcp) to expand functionality.\n\n\n### Troubleshooting\n\n#### MCP won't run in Claude\n\nIf you get an error when running Claude that the MCP is not working, you may need to edit your Claude config file and put an absolute path for the UV command. More info [here](https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fadb-mcp\u002Fissues\u002F5#issuecomment-2829817624).\n\n#### All fonts not available\n\nThe MCP server will return a list of available fonts, but depending on the number of fonts installed on your system, may omit some to work around the amount of data that can be send to the AI. By default it will list the first 1000 fonts sorted in alphabetical order.\n\nYou can tell the AI to use a specific font, using its postscript name.\n\n#### Plugin won't install or connect\n\n*   Make sure the app is running before you try to load the plugin.\n*   In the UXP developer tool click the debug button next to load, and see if there are any errors.\n*   Make sure the node \u002F proxy server is running. If you plugin connects you should see output similar to:\n\n```\nadb-mcp Command proxy server running on ws:\u002F\u002Flocalhost:3001\nUser connected: Ud6L4CjMWGAeofYAAAAB\nClient Ud6L4CjMWGAeofYAAAAB registered for application: photoshop\n```\n\n*   When you press the connect button, if it still says \"Connect\" it means there was either an error, or it can't connect to the proxy server. You can view the error in the UXP Developer App, by opening the Developer Workspace and click \"Debug\".\n\n#### Errors within AI client\n\n* If something fails on the AI side, it will usually tell you the issue. If you click the command \u002F code box, you can see the error.\n* The first thing to check if there is an issue is to make sure the plugin in Photoshop \u002F Premiere is connected, and that the node proxy server is running.\n* If response times get really slow, check if the AI servers are under load, and that you do not have too much text in the current conversation (restarting a new chat can sometimes help speed up, but you will lose the context).\n\nIf you continue to have issues post an [issue](https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fadb-mcp\u002Fissuesrd.gg\u002Ffgxw9t37D7). Include as much information as you can (OS, App, App version, and debug info or errors).\n\n## Development\n\nAdding new functionality is relatively easy, and requires:\n\n1. Adding the API and parameters in the *mcp\u002Fps-mcp.py* \u002F *mcp\u002Fpr-mcp.py* file (which is used by the AI)\n2. Implementing the API in the *uxp\u002Fps\u002Fcommands\u002Findex.js* \u002F *uxp\u002Fpr\u002Fcommands\u002Findex.js* file.\n\nThis [thread](https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fadb-mcp\u002Fissues\u002F10#issuecomment-3191698528) has some info on how to add functionality.\n\n## Questions, Feature Requests, Feedback\n\nIf you have any questions, feature requests, need help, or just want to chat, join the [discord](https:\u002F\u002Fdiscord.gg\u002Ffgxw9t37D7).\n\nYou can also log bugs and feature requests on the [issues page](https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fadb-mcp\u002Fissues).\n\n## License\n\nProject released under a [MIT License](LICENSE.md).\n\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-orange.svg)](LICENSE.md)\n\n\n","# adb-mcp\n\nadb-mcp 是一个概念验证项目，旨在通过 MCP 协议为大型语言模型（LLM）提供接口，从而实现人工智能对 Adobe 工具（Adobe Photoshop 和 Adobe Premiere）的控制。\n\n该项目并未获得 Adobe 的认可或支持。\n\n它已在 Anthropic 的 Claude 桌面版（Mac 和 Windows）以及 OpenAI Agent SDK 上进行了测试，允许 AI 客户端控制 Adobe Photoshop 和 Adobe Premiere。理论上，只要支持 MCP 协议的任何 AI 应用程序或 LLM 都可以使用该工具，并且其架构设计能够兼容多种 Adobe 应用程序。\n\n示例用法包括：\n\n- 向 Claude 提供在 Photoshop 中逐步操作的指令，构建一个基于对话式的界面（尤其适合初学者）。\n- 向 Claude 下达任务（例如创建一张类似宝丽来照片的 Instagram 帖子、制作双重曝光效果），并让其从头到尾完成，作为模板使用。\n- 请求 Claude 为你生成定制化的 Photoshop 教程，先创建一个示例文件，再提供逐步骤的操作说明。\n- 将 Claude 用作 Photoshop 的实用工具（例如让 Claude 将所有图层重命名为统一格式）。\n- 让 Claude 创建新的 Premiere 项目，并预先填充片段、转场、特效和音频。\n\n[观看视频示例](https:\u002F\u002Fwww.youtube.com\u002Fplaylist?list=PLrZcuHfRluqt5JQiKzMWefUb0Xumb7MkI)\n\n由于当前 Premiere 插件 API 的限制，Premiere 代理的功能相比 Photoshop 代理稍显有限。\n\n## 工作原理\n\n该概念验证项目通过以下方式实现：\n\n- 一个 MCP 服务器，为 AI 或 LLM 提供访问 Adobe Photoshop 功能的接口。\n- 一个基于 Node.js 的命令代理服务器，位于 MCP 服务器与 Adobe 应用程序插件之间。\n- 一个 Adobe 应用程序（Photoshop 和 Premiere）插件，用于监听命令并驱动软件运行。\n\n**AI** \u003C-> **MCP 服务器** \u003C-> **命令代理服务器** \u003C-> **Photoshop \u002F Premiere UXP 插件** \u003C-> **Photoshop \u002F Premiere**\n\n之所以需要代理服务器，是因为基于 UXP 的 JavaScript 插件公开 API 不支持以服务器模式监听套接字连接，因此无法让 MCP 服务器直接与其建立连接（它只能作为客户端连接到套接字）。\n\n## 系统要求\n\n要运行此项目，需满足以下条件：\n\n- 支持 MCP 协议的 AI LLM（已测试过 Mac 和 Windows 上的 Claude 桌面版，以及 OpenAI Agent SDK）。\n- Python 3，用于运行本项目提供的 MCP 服务器。\n- Node.js，用于搭建 MCP 服务器与 Photoshop 之间的代理。\n- Adobe UXP 开发者工具（可通过 Creative Cloud 获取），用于安装和调试连接代理的 Photoshop \u002F Premiere 插件。\n- Adobe Photoshop（26.0 或更高版本），并已安装 MCP 插件；或 Adobe Premiere Beta（25.3 Build 46 或更高版本）。\n\n## 安装步骤\n\n本指南假设您使用的是 Claude 桌面版。其他兼容 MCP 协议的 AI 应用程序应遵循类似的安装流程。\n\n\n### 下载源代码\n从 [主项目页面](https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fadb-mcp) 克隆或下载源代码。\n\n### 安装 Claude 桌面版\n1. 下载并安装 [Claude 桌面版](https:\u002F\u002Fclaude.ai\u002Fdownload)。\n2. 启动 Claude 桌面版，确认其正常运行。\n\n注意：您可以使用任何支持 MCP 协议的客户端或代码，只需按照其配置说明进行操作即可。\n\n### 安装用于开发的 MCP 工具\n进入项目目录并执行以下命令：\n\n#### Photoshop\n```bash\nuv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with numpy ps-mcp.py\n```\n\n#### Premiere Pro\n```bash\nuv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow pr-mcp.py\n```\n\n#### InDesign\n```bash\nuv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow id-mcp.py\n```\n\n#### AfterEffects\n```bash\nuv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow ae-mcp.py\n```\n\n#### Illustrator\n```bash\nuv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow ai-mcp.py\n```\n\n安装完成后，请重启 Claude 桌面版。\n\n### 设置代理服务器\n\n#### 使用预编译的可执行文件（推荐）\n1. 从最新发布的 [release 页面](https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fadb-mcp\u002Freleases) 下载适用于您平台的可执行文件（文件名如 `adb-proxy-socket-macos-x64.zip`（Intel）、`adb-proxy-socket-macos-arm64.zip`（Silicon）或 `adb-proxy-socket-win-x64.exe.zip`）。\n2. 解压可执行文件。\n3. 双击运行，或在控制台\u002F终端中执行。\n\n#### 从源码运行\n1. 进入 adb-proxy-socket 目录。\n2. 执行 `node proxy.js`。\n\n您应该会看到类似以下的消息：\n   `Photoshop MCP 命令代理服务器正在 ws:\u002F\u002Flocalhost:3001 上运行`\n\n**请保持此进程运行**——代理服务器必须持续运行，才能使 Claude 与 Adobe 插件进行通信。\n\n### 安装插件\n\n#### Photoshop、Premiere Pro、InDesign（UXP）\n\n1. 从 Creative Cloud 启动 **UXP 开发者工具**  \n2. 在提示时启用开发者模式  \n3. 选择 **文件 > 添加插件**  \n4. 导航到相应目录并选择 **manifest.json**：  \n   - **Photoshop**：`uxp\u002Fps\u002Fmanifest.json`  \n   - **Premiere Pro**：`uxp\u002Fpr\u002Fmanifest.json`  \n   - **InDesign**：`uxp\u002Fid\u002Fmanifest.json`  \n5. 点击 **加载**  \n6. 在您的 Adobe 应用程序中，打开插件面板并点击 **连接**\n\n##### 在 Photoshop 中启用开发者模式\n\n**对于 Photoshop：**  \n1. 启动 Photoshop（2025\u002F26.0 或更高版本）  \n2. 前往 **设置 > 插件**，勾选 **“启用开发者模式”**  \n3. 重启 Photoshop  \n\n#### AfterEffects、Illustrator（CEP）\n\n##### Mac\n1. 确保以下目录存在（如果不存在则创建这些目录）：  \n   `\u002FUsers\u002FUSERNAME\u002FLibrary\u002FApplication Support\u002FAdobe\u002FCEP\u002Fextensions`\n\n2. 进入 extensions 目录，创建一个指向 CEP 目录中 AfterEffect 或 Illustrator 插件的符号链接。  \n```bash\ncd \u002FUsers\u002FUSERNAME\u002FLibrary\u002FApplication Support\u002FAdobe\u002FCEP\u002Fextensions\nln -s \u002FUsers\u002FUSERNAME\u002Fsrc\u002Fadb-mcp\u002Fcep\u002Fcom.mikechambers.ae com.mikechambers.ae\n```\n或  \n```bash\ncd \u002FUsers\u002FUSERNAME\u002FLibrary\u002FApplication Support\u002FAdobe\u002FCEP\u002Fextensions\nln -s \u002FUsers\u002FUSERNAME\u002Fsrc\u002Fadb-mcp\u002Fcep\u002Fcom.mikechambers.ai com.mikechambers.ai\n```\n\n##### Windows\n1. 确保以下目录存在（如果不存在则创建这些目录）：  \n   `C:\\Users\\USERNAME\\AppData\\Roaming\\Adobe\\CEP\\extensions`\n\n2. 以管理员身份打开命令提示符（或在 Windows 设置中启用开发者模式）\n\n3. 创建一个连接点或符号链接，指向 CEP 目录中的 AfterEffect 或 Illustrator 插件：  \n```cmd\nmklink \u002FD \"C:\\Users\\USERNAME\\AppData\\Roaming\\Adobe\\CEP\\extensions\\com.mikechambers.ae\" \"C:\\Users\\USERNAME\\src\\adb-mcp\\cep\\com.mikechambers.ae\"\n```\n或  \n```cmd\nmklink \u002FD \"C:\\Users\\USERNAME\\AppData\\Roaming\\Adobe\\CEP\\extensions\\com.mikechambers.ai\" \"C:\\Users\\USERNAME\\src\\adb-mcp\\cep\\com.mikechambers.ai\"\n```\n\n注意：如果您不想使用符号链接，也可以将 `com.mikechambers.ae` 或 `com.mikechambers.ai` 复制到 CEP 目录中。\n\n### 在 Adobe 应用中使用 Claude\n\n启动以下内容：\n\n1. Claude Desktop  \n2. adb-proxy-socket Node.js 服务器  \n3. 启动 Photoshop、Premiere、InDesign、AfterEffects、Illustrator  \n\n_提示：在 Claude 中为 Photoshop 或 Premiere Pro 创建一个项目，并预先将该应用特定的指令加载到项目的知识库中。_\n\n#### Photoshop\n1. 启动 UXP 开发者工具，点击 _Photoshop MCP Agent_ 的加载按钮  \n2. 在 Photoshop 中，如果 MCP Agent 面板未打开，请前往 _插件 > Photoshop MCP Agent > Photoshop MCP Agent_ 打开它  \n3. 在 Photoshop 的代理面板中点击“连接”\n\n现在您可以切换到 Claude Desktop。在开始会话之前，您应该通过点击插座图标（从 MCP 附加），然后选择 _选择集成 > Adobe Photoshop > config:\u002F\u002Fget_instructions_，加载指令资源，以便为 Claude 提供指导和信息。\n\n#### Premiere\n1. 启动 UXP 开发者工具，点击 _Premiere MCP Agent_ 的加载按钮  \n2. 在 Premiere 中，如果 MCP Agent 面板未打开，请前往 _窗口 > UXP 插件 > Premiere MCP Agent > Premiere MCP Agent_ 打开它  \n3. 在 Premiere 的代理面板中点击“连接”\n\n#### InDesign\n1. 启动 UXP 开发者工具，点击 _InDesign MCP Agent_ 的加载按钮  \n2. 在 InDesign 中，如果 MCP Agent 面板未打开，请前往 _插件 > InDesign MCP Agent > InDesign MCP Agent_ 打开它  \n3. 在 InDesign 的代理面板中点击“连接”\n\n#### AfterEffects\n1. _窗口 > 扩展功能 > Illustrator MCP Agent_\n\n#### Illustrator\n\n1. 打开一个文件（除非有文件打开，否则插件不会启动）  \n2. _窗口 > 扩展功能 > Illustrator MCP Agent_\n\n请注意，每次重启 Photoshop、Premiere 和 InDesign 时，都必须通过 UXP 开发者应用程序重新加载插件。\n\n### 设置会话\n\n在聊天输入框中，点击“+”按钮。然后选择“从 Adobe Photoshop \u002F Premiere 添加”，再选择 *config:\u002F\u002Fget_instructions*。这会将指令加载到提示中。提交给 Claude，待其处理完毕后，您就可以开始使用了。\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmikechambers_adb-mcp_readme_040a4ba7fc78.png\" width=\"300\">\n\n这将有助于减少 AI 在使用应用程序时出现的错误。\n\n### 提示方法\n\n在任何时候，您都可以询问以下问题：\n\n```\n你能列出可用于操作 Photoshop \u002F Premiere 的 API \u002F 函数吗？\n```\n\nAI 将会列出所有可用的功能。\n\n在进行提示时，无需引用 API，只需使用自然语言给出指令即可。\n\n例如：\n\n```\n创建一个蓝色背景的新 Photoshop 文件，尺寸为 1080×720，分辨率为 300 dpi。\n```\n\n```\n为 Instagram 发布创建一个新的 Photoshop 文件。\n```\n\n```\n在 Photoshop 中制作一张女性与森林的双重曝光图像。\n```\n\n```\n生成一张森林的图像，然后添加剪贴蒙版，只显示中间圆形区域。\n```\n\n```\n用 Photoshop 做点酷炫的东西吧。\n```\n\n```\n在 Premiere 的时间线上所有片段之间添加交叉淡入淡出过渡效果。\n```\n\n### 小贴士\n\n#### 通用\n* 当你让AI查看Photoshop或Premiere Pro中的内容时，返回的图像会显示在聊天中的“工具调用”项中。只有当整个回复都添加到聊天中后，它才会出现。\n* 在提示AI时，可以要求它思考并检查自己的工作。\n* 你提供的指导越多（例如“考虑使用剪贴蒙版”），结果就会越好。\n* 模型越先进，或者分配给模型的资源越多，AI的表现就越出色、越有创意。\n* 一般情况下，在AI执行任务时不要在Adobe应用程序中进行更改。如果确实需要更改，请务必告知AI。\n* AI会从错误中学习，但每次开始新对话时都会丢失记忆。你可以引导它以不同的方式完成任务，然后让它重新开始，它应该会遵循新的方法。\n\n目前，AI可以访问Photoshop、Premiere、InDesign、Illustrator和After Effects的部分功能。总体来说，这种方法是提供较低级别的工具，以便AI掌握基础操作，从而完成更复杂的任务。\n\n需要注意的是，对于After Effects和Illustrator，有一个低级别的Extend Script API，可以让大型语言模型运行任意的Extend脚本，从而实现几乎任何操作。\n\nPhotoshop插件的功能比Premiere更多。\n\n默认情况下，AI无法直接访问文件，不过如果你安装了[Claude文件系统MCP服务器](https:\u002F\u002Fwww.claudemcp.com\u002Fservers\u002Ffilesystem)，它就可以访问并加载文件到Photoshop或Premiere中（打开文件并嵌入图像）。\n\n#### Photoshop\n\n* 你可以让AI查看Photoshop文件的内容，它应该能够看到输出结果。\n* 目前AI在正确调整文本大小和位置方面存在问题，因此提供字体大小的指导建议会有帮助，同时也可以告诉AI将文本相对于画布对齐。\n* AI可以访问系统上所有的PostScript字体。如果要指定某种字体，必须使用其PostScript名称（你也可以请AI帮你查找）。\n* 你可以向AI寻求建议。它有时会提出非常有用的想法或反馈。\n\n#### Premiere\n\n* 目前插件假设你只处理一个序列。\n* 将Premiere Pro MCP与[media-utils-mcp](https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fmedia-utils-mcp)配合使用，可以扩展功能。\n\n\n### 故障排除\n\n#### MCP无法在Claude中运行\n\n如果在运行Claude时出现MCP无法正常工作的错误，你可能需要编辑Claude的配置文件，并为UV命令设置绝对路径。更多信息请参见[这里](https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fadb-mcp\u002Fissues\u002F5#issuecomment-2829817624)。\n\n#### 并非所有字体都可用\n\nMCP服务器会返回可用字体的列表，但根据你系统上安装的字体数量，可能会省略部分字体，以避免发送过多数据给AI。默认情况下，它会列出按字母顺序排列的前1000种字体。\n\n你可以通过指定字体的PostScript名称来让AI使用特定字体。\n\n#### 插件无法安装或连接\n\n* 确保在尝试加载插件之前，应用程序已经运行。\n* 在UXP开发者工具中，点击“加载”旁边的调试按钮，查看是否有错误信息。\n* 确保节点\u002F代理服务器正在运行。如果插件成功连接，你应该会看到类似以下的输出：\n\n```\nadb-mcp 命令代理服务器正在 ws:\u002F\u002Flocalhost:3001 上运行\n用户已连接：Ud6L4CjMWGAeofYAAAAB\n客户端 Ud6L4CjMWGAeofYAAAAB 已注册到 photoshop 应用程序\n```\n\n* 当你按下连接按钮时，如果仍然显示“连接”，则表示出现了错误，或者无法连接到代理服务器。你可以在UXP开发者应用中查看错误信息，打开开发者工作区并点击“调试”。\n\n#### AI客户端内部的错误\n\n* 如果AI端出现问题，它通常会告诉你具体原因。点击命令\u002F代码框即可查看错误信息。\n* 遇到问题时，首先要检查Photoshop或Premiere中的插件是否已连接，以及节点代理服务器是否正在运行。\n* 如果响应时间变得非常慢，检查AI服务器是否负载过高，同时确保当前对话中的文本量不要过大（有时重新开始一次新对话可以帮助加快速度，但你会失去之前的上下文）。\n\n如果你仍然遇到问题，请在[Github仓库](https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fadb-mcp\u002Fissuesrd.gg\u002Ffgxw9t37D7)上提交一个问题。请尽可能提供详细信息（操作系统、应用程序、应用程序版本以及调试信息或错误）。\n\n## 开发\n\n添加新功能相对容易，只需按照以下步骤操作：\n\n1. 在*mcp\u002Fps-mcp.py*或*mcp\u002Fpr-mcp.py*文件中添加API和参数（这些文件供AI调用）。\n2. 在*uxp\u002Fps\u002Fcommands\u002Findex.js*或*uxp\u002Fpr\u002Fcommands\u002Findex.js*文件中实现该API。\n\n这个[讨论帖](https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fadb-mcp\u002Fissues\u002F10#issuecomment-3191698528)提供了关于如何添加功能的一些信息。\n\n## 问题、功能请求、反馈\n\n如果你有任何问题、功能请求、需要帮助，或者只是想聊一聊，欢迎加入我们的[Discord服务器](https:\u002F\u002Fdiscord.gg\u002Ffgxw9t37D7)。\n\n你也可以在[Github仓库的问题页面](https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fadb-mcp\u002Fissues)上记录Bug和功能请求。\n\n## 许可证\n\n该项目采用[MIT许可证](LICENSE.md)发布。\n\n[![许可证：MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-orange.svg)](LICENSE.md)","# adb-mcp 快速上手指南\n\n`adb-mcp` 是一个概念验证项目，旨在通过 MCP（Model Context Protocol）协议让 AI（如 Claude）直接控制 Adobe 系列软件（Photoshop、Premiere Pro 等）。它允许用户通过自然语言指令让 AI 执行复杂的编辑任务、生成教程或自动化工作流。\n\n> **注意**：本项目非 Adobe 官方出品，也不受其支持。\n\n## 环境准备\n\n在开始之前，请确保您的系统满足以下要求：\n\n### 系统要求\n- **操作系统**：macOS (Intel\u002FApple Silicon) 或 Windows\n- **Adobe 软件**：\n  - Photoshop 26.0 或更高版本\n  - Premiere Pro Beta (25.3 Build 46 或更高版本)\n  - 或其他支持的 Adobe 应用 (InDesign, AfterEffects, Illustrator)\n\n### 前置依赖\n您需要安装以下开发工具：\n1. **Python 3**：用于运行 MCP 服务器。\n2. **Node.js**：用于运行命令代理服务器（Proxy Server）。\n3. **uv**：Python 包管理工具（推荐用于快速安装依赖）。\n4. **Adobe UXP Developer Tool**：通过 Creative Cloud 安装，用于加载和调试插件。\n5. **支持 MCP 的 AI 客户端**：例如 [Claude Desktop](https:\u002F\u002Fclaude.ai\u002Fdownload) 或 OpenAI Agent SDK。\n\n## 安装步骤\n\n### 1. 获取源代码\n克隆或下载项目代码：\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fadb-mcp.git\ncd adb-mcp\n```\n\n### 2. 配置 MCP 服务器\n根据您的目标软件，运行相应的安装命令。以下以 **Photoshop** 和 **Premiere Pro** 为例（其他软件请参考 README 中的对应命令）：\n\n**Photoshop:**\n```bash\nuv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with numpy ps-mcp.py\n```\n\n**Premiere Pro:**\n```bash\nuv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow pr-mcp.py\n```\n\n*安装完成后，请重启 Claude Desktop。*\n\n### 3. 启动代理服务器 (Proxy Server)\nMCP 服务器需要通过一个 Node.js 代理才能与 Adobe 插件通信。您可以选择使用预编译文件或从源码运行。\n\n**方式 A：使用预编译可执行文件（推荐）**\n1. 前往 [Releases 页面](https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fadb-mcp\u002Freleases) 下载对应系统的压缩包（如 `adb-proxy-socket-macos-arm64.zip`）。\n2. 解压并双击运行，或在终端中运行该可执行文件。\n\n**方式 B：从源码运行**\n```bash\ncd adb-proxy-socket\nnode proxy.js\n```\n*成功启动后，您应看到类似提示：`Photoshop MCP Command proxy server running on ws:\u002F\u002Flocalhost:3001`。请保持此窗口运行。*\n\n### 4. 安装 Adobe 插件\n使用 **UXP Developer Tool** 加载插件：\n\n1. 打开 **UXP Developer Tool**。\n2. 选择 **File > Add Plugin**。\n3. 导航至项目目录下的对应 `manifest.json` 文件：\n   - **Photoshop**: `uxp\u002Fps\u002Fmanifest.json`\n   - **Premiere Pro**: `uxp\u002Fpr\u002Fmanifest.json`\n4. 点击 **Load**。\n5. **启用开发者模式**（仅限 Photoshop）：\n   - 打开 Photoshop，进入 **Settings > Plugins**，勾选 **\"Enable Developer Mode\"** 并重启软件。\n\n> **注意**：对于 AfterEffects 和 Illustrator，需通过创建符号链接将 `cep` 目录下的插件文件夹映射到 Adobe 扩展目录，具体命令请参考原文 README 的 \"Install Plugins\" 章节。\n\n## 基本使用\n\n完成上述配置后，按以下顺序启动服务：\n1. 运行 **adb-proxy-socket** (保持后台运行)。\n2. 启动 **Claude Desktop**。\n3. 打开 **Photoshop** (或 Premiere 等)，在插件面板中找到 \"MCP Agent\" 并点击 **Connect**。\n\n### 建立会话\n在 Claude Desktop 的聊天输入框中：\n1. 点击 **\"+\"** 按钮。\n2. 选择 **Attach from MCP** (或类似集成选项)。\n3. 选择 **Adobe Photoshop** > **config:\u002F\u002Fget_instructions**。\n4. 发送该消息，让 AI 加载功能指令集。\n\n### 使用示例\n加载指令后，您可以直接使用自然语言下达复杂指令，无需提及具体 API。\n\n**示例 1：创建基础文件**\n```text\n创建一个全新的 Photoshop 文件，背景为蓝色，尺寸宽 1080 高 720，分辨率 300 dpi。\n```\n\n**示例 2：创意任务**\n```text\n在 Photoshop 中制作一张双重曝光图片，主体是一位女性，背景是森林。\n```\n\n**示例 3：视频编辑 (Premiere)**\n```text\n在 Premiere 时间轴的所有剪辑之间添加交叉淡入淡出过渡效果。\n```\n\n**示例 4：查询能力**\n```text\n列出当前可用于操作 Photoshop 的所有 API 或函数。\n```\n\n### 实用技巧\n- **查看结果**：当 AI 执行截图或图像生成任务时，结果会显示在聊天的 \"Tool Call\" 项中。\n- **引导优化**：如果 AI 排版不准确，可以提示它“考虑使用剪贴蒙版”或“相对于画布居中对齐”。\n- **避免干扰**：在 AI 执行任务期间，尽量不要手动操作 Adobe 软件，以免状态不同步。如需修改，请告知 AI。\n- **文件访问**：默认情况下 AI 无法直接读取本地文件。如需让 AI 打开图片或素材，建议额外安装 [Claude File System MCP server](https:\u002F\u002Fwww.claudemcp.com\u002Fservers\u002Ffilesystem)。","一位刚接手电商设计任务的新人设计师，需要在极短时间内为新品上市制作一系列风格统一的社交媒体宣传图。\n\n### 没有 adb-mcp 时\n- 面对复杂的 Photoshop 界面和数百个功能按钮，新人因不熟悉图层样式、混合模式等专业操作而束手无策，学习成本极高。\n- 每次修改需求（如调整色调或更换文案）都需要人工重复点击菜单、拖拽图层，机械性操作占据了大量创意时间。\n- 难以保证多张海报的图层命名规范和结构一致，导致后续团队协作或批量修改时混乱不堪，极易出错。\n- 想要复现某种特定视觉效果（如宝丽来复古风）时，需花费数小时在网络上搜索教程并一步步手动尝试，效率低下。\n\n### 使用 adb-mcp 后\n- 设计师只需通过自然语言向 Claude 描述“创建一张宝丽来风格的 Instagram 海报”，adb-mcp 即可驱动 Photoshop 自动完成从新建画布到应用滤镜的全流程。\n- 当需要调整细节时，直接指令“将所有文字层改为无衬线字体并居中”，adb-mcp 瞬间执行批量修改，将重复劳动缩短至秒级。\n- 利用 adb-mcp 的自动化能力，所有生成的图层自动按“类别_内容_版本”格式规范命名，确保文件结构清晰，便于团队无缝交接。\n- 遇到复杂特效需求，让 Claude 基于 adb-mcp 生成包含示例文件和分步指南的定制教程，新人可边看边学，快速掌握核心技巧。\n\nadb-mcp 通过将自然语言转化为精准的软件操作，彻底打破了专业设计工具的高门槛，让创意构思能零损耗地直接落地为视觉成品。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmikechambers_adb-mcp_fa2db773.png","mikechambers","Mike Chambers","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fmikechambers_b9ce5eaa.png","mikechambers@gmail.com","mesh","http:\u002F\u002Fwww.mikechambers.com","https:\u002F\u002Fgithub.com\u002Fmikechambers",[82,86,90,94,98],{"name":83,"color":84,"percentage":85},"JavaScript","#f1e05a",84.9,{"name":87,"color":88,"percentage":89},"Python","#3572A5",13.8,{"name":91,"color":92,"percentage":93},"CSS","#663399",0.6,{"name":95,"color":96,"percentage":97},"HTML","#e34c26",0.4,{"name":99,"color":100,"percentage":101},"Shell","#89e051",0.3,570,81,"2026-04-18T08:32:17","MIT",4,"macOS, Windows","未说明",{"notes":110,"python":111,"dependencies":112},"1. 必须安装特定版本的 Adobe 软件：Photoshop 26.0+ 或 Premiere Beta 25.3 Build 46+。2. 需要安装 NodeJS 以运行代理服务器 (proxy server)。3. 需通过 Creative Cloud 安装 Adobe UXP Developer Tool 用于加载插件。4. 推荐使用预编译的代理服务器可执行文件，或从源码运行 Node.js 脚本。5. 在 Photoshop 中需在设置里启用“开发者模式”。6. After Effects 和 Illustrator 插件安装需要在系统中创建符号链接 (Mac) 或 junction (Windows)。7. 运行时需同时保持 Claude Desktop、代理服务器和 Adobe 软件处于开启状态。","3.x (需配合 uv 运行)",[113,114,115,116,117,118,119,120,121,122],"fonttools","python-socketio","mcp","requests","websocket-client","numpy","pillow","NodeJS","Adobe UXP Developer Tool","Adobe Creative Cloud Apps (Photoshop\u002FPremiere\u002Fetc.)",[13,45],"2026-03-27T02:49:30.150509","2026-04-19T09:37:51.426678",[127,132],{"id":128,"question_zh":129,"answer_zh":130,"source_url":131},42306,"为什么无法安装 Premiere Pro 插件或遇到 UXP 相关错误？","该插件目前仅在 Adobe 软件的 Beta 版本上正常工作，正式发布版（Release Version）尚不支持 UXP。此外，请勿使用预构建的 UXP 包，因为它们存在 Bug（维护者已将其从发布版中移除）。请确保您使用的是 Beta 版本的 Adobe 软件进行安装和测试。","https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fadb-mcp\u002Fissues\u002F12",{"id":133,"question_zh":134,"answer_zh":135,"source_url":136},42307,"调用 API 创建 Photoshop 新文档时出现 'TypeError: Cannot set properties of null' 错误怎么办？","此错误通常是因为新建的文档中没有背景图层（Background），导致代码尝试设置 'allLocked' 属性时失败。该问题已在 'codecheck' 分支的代码中修复。如果您遇到此问题，可以尝试切换到该分支获取修复版本，或者确保在创建文档后正确处理背景图层的初始化。","https:\u002F\u002Fgithub.com\u002Fmikechambers\u002Fadb-mcp\u002Fissues\u002F7",[138,142,146],{"id":139,"version":140,"summary_zh":66,"released_at":141},334409,"v0.85.4","2025-08-07T01:14:09",{"id":143,"version":144,"summary_zh":66,"released_at":145},334410,"v0.85.3","2025-07-25T02:26:35",{"id":147,"version":148,"summary_zh":66,"released_at":149},334411,"v0.85.2","2025-07-08T22:59:19"]