Lightroom MCP

Lightroom经典MCP服务器

让Claude（和其他AI助手）与您的 Adobe Lightroom经典版 照片目录。搜索照片、设置评级、编辑开发设置、管理收藏、导入/导出——所有这些都是通过聊天完成的。

](https://www.npmjs.com/package/@mskalski/lightroom-mcp) 

适用于： 克劳德桌面、克劳德代码、Codex CLI、游标、Windsurf、VS代码。 需要： macOS或Windows上的Lightroom Classic。没有别的——不需要编程。

______________________________________________________________________

安装（Claude Desktop-最简单，3个步骤）

这是推荐的路径。大约需要2分钟，不需要终端。

1.下载安装程序

去 最新发布页面 并下载以结尾的文件 .mcpb （它靠近顶部，被称为 lightroom-mcp-.mcpb).

2.双击下载的文件

Claude Desktop会自动打开并询问： *“是否安装Lightroom Classic扩展？”*。单击 安装.

还没有克劳德桌面？免费获取 。它在Mac和Windows上运行。

3.在Lightroom中打开插件

1. 退出并重新打开Lightroom Classic。 （插件需要重新启动才能显示。）
2. 在Lightroom中，单击 文件 在菜单栏中→ 插件管理器.
3. 在左侧列表中，单击 光室MCP.
4. 在右侧，单击 启动服务器 按钮。
5. 您应该看到“服务器正在运行”出现。完成！

试试看

打开克劳德桌面，键入：

*列出我所有的Lightroom收藏。*

克劳德会在你的目录中列出每一个收藏品。

还有一些事情要尝试：

• *“查找我去年夏天的所有五星级照片。”*
• *“将关键字‘公文包’添加到我在Lightroom中选择的照片中。”*
• *“将‘生动’显影预设应用于这些照片。”*
• *“将所选照片以2000像素宽的JPEG格式导出到我的桌面。”*

______________________________________________________________________

安装（其他AI工具）

已经在使用Claude Code、Codex、Cursor、Windsurf或VS Code了吗？选择下面的工具。 所有路径仍然以上述部分的Lightroom步骤结束 --重新启动Lightroom并单击 启动服务器 在插件管理器中。

Claude Code

相同 .mcpb 文件如上面的Claude Desktop——Claude Code也接受它。或者通过CLI安装：

claude mcp add lightroom -- npx -y @mskalski/lightroom-mcp

Codex CLI

codex mcp add lightroom -- npx -y @mskalski/lightroom-mcp

Lightroom插件在Codex第一次与服务器通信时自行安装。

Cursor / Windsurf / VS Code (Continue, Cline, Roo, ...)

打开客户的MCP设置并添加：

{
  "mcpServers": {
    "lightroom": {
      "command": "npx",
      "args": ["-y", "@mskalski/lightroom-mcp"]
    }
  }
}

插件会在客户端首次启动服务器时自行安装。如果你的客户端只在第一次工具调用时启动服务器，你可以提前安装插件：

npx -y @mskalski/lightroom-mcp install-plugin

No Node.js installed? Use the standalone binary

1. 从下载正确的文件 最新版本:

- Mac（苹果硅，M1/M2/M3/M4）： lightroom-mcp-darwin-arm64 - Mac（英特尔）： lightroom-mcp-darwin-x64 - 窗户： lightroom-mcp-windows-x64.exe

1. 仅限macOS --使其可运行并绕过Gatekeeper（二进制文件未签名）：

   chmod +x ~/Downloads/lightroom-mcp-darwin-arm64
   xattr -d com.apple.quarantine ~/Downloads/lightroom-mcp-darwin-arm64

1. 安装Lightroom插件：

   ~/Downloads/lightroom-mcp-darwin-arm64 install-plugin

1. 将AI工具指向二进制文件的完整路径。Codex示例：

   codex mcp add lightroom -- /Users/you/Downloads/lightroom-mcp-darwin-arm64

Install the Lightroom plugin manually (any client)

如果你更愿意手动插入插件：

1. 从下载匹配的zip 最新版本:

- 雨衣： LightroomMCP-macos.lrplugin.zip - 窗户： LightroomMCP-windows.lrplugin.zip

1. 解压缩它。你会得到一个名为的文件夹 LightroomMCP.lrplugin.
2. 将该文件夹移动到Lightroom的Modules文件夹中：

- 雨衣： ~/Library/Application Support/Adobe/Lightroom/Modules/ - 窗户： %APPDATA%\Adobe\Lightroom\Modules\ - （如果 Modules 文件夹不存在，请创建它。）

1. 重新启动Lightroom→ 插件管理器 → 启动服务器.

______________________________________________________________________

有什么不起作用的吗？

1. 开放式照明室→ File → 插件管理器→ 光室MCP→ 显示状态。两个套接字都应该说 connected: true。如果没有，请单击 启动服务器.
2. 确保你 完全退出并重新打开Lightroom 安装后（Mac上的Cmd+Q，Windows上的Alt+F4）。仅“重新加载插件”是不够的。
3. 看 故障排除 下面是具体的错误。

工具

完整的模式和参数文档： server/src/list-tools-handler.ts.

运作原理

┌─────────────┐    stdio    ┌──────────────────┐  TCP :58763 →   ┌──────────────────┐
│  AI client  │ ◄─────────► │   MCP server     │ ──────────────► │ Lightroom plugin │
│ (Claude/    │             │  (Node TCP)      │ ←────────────── │   (LrSocket)     │
│  Codex/...) │             └──────────────────┘   ← TCP :58764  └──────────────────┘
└─────────────┘                                                           │
                                                                          ▼
                                                                catalog:withReadAccessDo

插件绑定两个 LrSocket 本地主机上的服务器(58763 请求， 58764 响应）。服务器作为TCP客户端连接。Frame：以行分隔的JSON， \n 终结者。两侧自动重新连接。与MIDI2LR相同的双端口模式。

CLI参考

lightroom-mcp [stdio]            Run MCP over stdio (default)
lightroom-mcp install-plugin     Copy bundled plugin into Lightroom Modules folder
lightroom-mcp --help | --version

环境变量：

如果更改服务器端的端口，请在 插件管理器→ 光室MCP 为了匹配。

安全

该插件在中生成256位令牌 ~/.config/lightroom-mcp/token 上 启动服务器MCP服务器将其附加到每个请求中。仅限本地主机——没有远程攻击面。

开发

mise install                        # tools (node, bun)
mise run install                    # npm ci
mise run build                      # tsc
mise run test                       # jest
mise run mcpb                       # build .mcpb bundle
mise run binary                     # build single-file binaries via Bun
luacheck plugin --no-color --codes  # lint Lua plugin

回购布局：

• server/ --TypeScript MCP服务器（ESM、NodeNext）。
• plugin/LightroomMCP.lrplugin/ --Lightroom Classic加载的Lua插件。
• mcpb/manifest.json — .mcpb 捆绑清单。
• scripts/build-mcpb.mjs --打包.mcpb文件。
• scripts/build-binary.mjs --Bun --compile 每个目标二进制文件。
• manual-test.mjs --直接TCP探测（绕过MCP）。

添加新工具

1. 添加新 Handler*.lua 在...之下 plugin/LightroomMCP.lrplugin/.
2. 在 DISPATCH 桌子在 PluginInfoProvider.lua.
3. 在中添加架构条目 server/src/list-tools-handler.ts.
4. 在中声明任何新的LR全局变量 .luacheckrc.

故障排除

• failed to open localhost:58763 重新加载插件后 --旧的异步任务仍然拥有该端口。退出Lightroom（macOS上的Cmd+Q/Windows上的Alt+F4）并重新打开。
• 插件未连接 --点击 启动服务器 插件管理器；服务器将在1秒内重新连接。
• 超时错误 --处理程序可能正在扫描没有过滤器的大型目录；添加 rating, filename, keywords，或日期筛选器以缩小范围。
• macOS“无法打开，因为无法验证开发人员” （二进制路径）-- xattr -d com.apple.quarantine /path/to/binary。或右键单击→ 第一次打开。
• Windows SmartScreen阻止.exe --更多信息→ 无论如何都要跑。

日志：

许可证

麻省理工学院