内容
# RawTherapee MCP 服务器
[](https://github.com/lucamarien/rawtherapee-mcp-server/actions/workflows/ci.yml)
[](https://pypi.org/project/rawtherapee-mcp-server/)
[](https://pypi.org/project/rawtherapee-mcp-server/)
[](LICENSE)
用于 AI 辅助 RAW 照片开发的跨平台 [模型上下文协议](https://modelcontextprotocol.io/)（MCP）服务器，通过 [RawTherapee](https://rawtherapee.com/) 命令行界面。提供 **49 种工具**，用于配置文件生成、图像处理、视觉预览、批量操作、设备预设、基于亮度的局部调整、镜头校正、胶片模拟 LUT、配置文件继承和元数据隐私。
**独特之处：** LLM 可以*看到*它正在编辑的照片。预览工具通过 MCP 的 ImageContent 协议返回内联 Base64 图像，创建视觉反馈环路，AI 分析图像，调整设置，预览结果，然后迭代 — 就像人类编辑器一样。
## MCP 客户端兼容性
并非所有 MCP 客户端都以相同的方式处理内联图像。视觉反馈环路需要一个客户端来渲染工具响应中的 `ImageContent`，以及一个具有视觉能力的后台 LLM。
| 客户端 | MCP 支持 | 图片显示 | 视觉工作流 | 状态 |
|--------|------------|---------------|----------------|--------|
| **Claude Desktop** | 完整 | 是 | 完整 | 已测试 |
| **Claude Code** | 完整 | 否（终端） | 部分 | 已测试 — 图片不在终端中渲染，但处理和文本分析功能正常 |
| **Cursor** | 完整 | 应该有效 | 应该有效 | 未测试 — MCP 文档表明支持 ImageContent |
| **Windsurf** | 完整 | 应该有效 | 应该有效 | 未测试 |
| **Cline** | 部分 | 未知 | 未知 | 未测试 — 社区报告表明 ImageContent 可能无法渲染 ([#1865](https://github.com/cline/cline/issues/1865)) |
| **Zed** | 完整 | 未知 | 未知 | 未测试 |
**完整视觉工作流的最低要求：**
- MCP 客户端从工具响应中渲染 `ImageContent`（类型：”image”，数据：base64，mimeType：”image/jpeg”）
- 后台 LLM 支持视觉/图像分析（例如带有视觉的 Claude）
- 工具响应大小适应 ~150KB 预览（大多数客户端：1MB 限制）
**纯文本客户端：** 所有 49 种工具无需内联图像即可工作。预览工具返回文件路径代替。LLM 仍然可以读取 EXIF 元数据、直方图统计数据、生成配置文件、批量处理和使用亮度预设 — 视觉反馈环路是唯一需要图像支持的功能。
## 先决条件
- Python 3.11+
- [RawTherapee](https://rawtherapee.com/) 5.9+，并安装 CLI 组件
- MCP 兼容的客户端（参见上表）
在继续之前，请验证 RawTherapee CLI 可访问：
**Windows（PowerShell）：**
```powershell
& "C:\Program Files\RawTherapee\5.12\rawtherapee-cli.exe" --version
```
**macOS：**
```bash
/Applications/RawTherapee.app/Contents/MacOS/rawtherapee-cli --version
```
**Linux：**
```bash
rawtherapee-cli --version
```
## 安装
两种支持的方法 - 选择与您的优先级相符的方法：
| 方法 | 选择原因 |
|--------|---------------------|
| **uvx** | 最少的设置，无持久安装，标准的 MCP 社区模式 |
| **pip + venv** | 明确的版本控制，可预测的更新，更简单的调试，空气隔离的环境 |
### 选项 A - uvx
无需持久安装。uvx 按需下载、缓存和运行服务器。
**重要：** 始终固定特定版本。未固定的表单（`"rawtherapee-mcp-server"`）锁定到第一个已解析的版本，不会自动升级到新版本。请参阅 [更新](#updating) 以获取完整的刷新过程。
<details>
<summary><strong>Windows</strong> (<code>%APPDATA%\Claude\claude_desktop_config.json</code>)</summary>
```json
{
"mcpServers": {
"rawtherapee": {
"command": "uvx",
"args": ["rawtherapee-mcp-server@1.0.4"],
"env": {
"RT_CLI_PATH": "C:\\Program Files\\RawTherapee\\5.12\\rawtherapee-cli.exe",
"RT_OUTPUT_DIR": "C:\\Users\\YourName\\Pictures\\rawtherapee-output"
}
}
}
}
```
</details>
<details>
<summary><strong>macOS</strong> (<code>~/Library/Application Support/Claude/claude_desktop_config.json</code>)</summary>
```json
{
"mcpServers": {
"rawtherapee": {
"command": "uvx",
"args": ["rawtherapee-mcp-server@1.0.4"],
"env": {
"RT_OUTPUT_DIR": "/Users/yourname/Pictures/rawtherapee-output"
}
}
}
}
```
RawTherapee CLI 在 `/Applications/RawTherapee.app/Contents/MacOS/rawtherapee-cli` 处自动检测。如果您的安装位置不同，请设置 `RT_CLI_PATH`。
</details>
<details>
<summary><strong>Linux</strong> (<code>~/.config/Claude/claude_desktop_config.json</code>)</summary>
```json
{
"mcpServers": {
"rawtherapee": {
"command": "uvx",
"args": ["rawtherapee-mcp-server@1.0.4"],
"env": {
"RT_OUTPUT_DIR": "/home/yourname/Pictures/rawtherapee-output"
}
}
}
}
```
RawTherapee CLI 在 `/usr/bin/rawtherapee-cli` 处自动检测。如果需要，请设置 `RT_CLI_PATH`。
</details>
### 选项 B - pip + venv
使用专用虚拟环境进行显式安装。您可以确切控制运行的版本，并且更新是透明的。
#### 1. 创建 venv 并安装
**Windows（PowerShell）：**
```powershell
python -m venv "$env:USERPROFILE\.rawtherapee-mcp-env"
& "$env:USERPROFILE\.rawtherapee-mcp-env\Scripts\pip.exe" install rawtherapee-mcp-server
```
**macOS / Linux：**
```bash
python3 -m venv ~/.rawtherapee-mcp-env
~/.rawtherapee-mcp-env/bin/pip install rawtherapee-mcp-server
```
#### 2. 配置 Claude Desktop
将 Claude Desktop 指向 venv 的入口脚本。无需激活步骤 - 路径是绝对的。
<details>
<summary><strong>Windows</strong> (<code>%APPDATA%\Claude\claude_desktop_config.json</code>)</summary>
```json
{
"mcpServers": {
"rawtherapee": {
"command": "C:\\Users\\YourName\\.rawtherapee-mcp-env\\Scripts\\rawtherapee-mcp-server.exe",
"args": [],
"env": {
"RT_CLI_PATH": "C:\\Program Files\\RawTherapee\\5.12\\rawtherapee-cli.exe",
"RT_OUTPUT_DIR": "C:\\Users\\YourName\\Pictures\\rawtherapee-output"
}
}
}
}
```
替换 `YourName` 为您的实际 Windows 用户名。
</details>
<details>
<summary><strong>macOS</strong> (<code>~/Library/Application Support/Claude/claude_desktop_config.json</code>)</summary>
```json
{
"mcpServers": {
"rawtherapee": {
"command": "/Users/yourname/.rawtherapee-mcp-env/bin/rawtherapee-mcp-server",
"args": [],
"env": {
"RT_OUTPUT_DIR": "/Users/yourname/Pictures/rawtherapee-output"
}
}
}
}
```
</details>
<details>
<summary><strong>Linux</strong> (<code>~/.config/Claude/claude_desktop_config.json</code>)</summary>
```json
{
"mcpServers": {
"rawtherapee": {
"command": "/home/yourname/.rawtherapee-mcp-env/bin/rawtherapee-mcp-server",
"args": [],
"env": {
"RT_OUTPUT_DIR": "/home/yourname/Pictures/rawtherapee-output"
}
}
}
}
```
</details>
#### 3. 验证安装
**Windows：**
```powershell
& "$env:USERPROFILE\.rawtherapee-mcp-env\Scripts\python.exe" -c "import rawtherapee_mcp; print(rawtherapee_mcp.__version__)"
```
**macOS / Linux：**
```bash
~/.rawtherapee-mcp-env/bin/python -c "import rawtherapee_mcp; print(rawtherapee_mcp.__version__)"
```
预期输出：已安装的版本号（例如 `1.0.4`）。
编辑 `claude_desktop_config.json` 后，请完全退出并重启 Claude Desktop - 仅关闭窗口会在 macOS 和 Windows 上留下后台进程运行。
## 客户端配置
### Claude Desktop
RawTherapee CLI 路径在大多数系统上自动检测。如果自动检测失败或 RawTherapee 位于非标准位置，请设置 `RT_CLI_PATH`。
<details>
<summary><strong>Windows</strong> (<code>%APPDATA%\Claude\claude_desktop_config.json</code>)</summary>
```json
{
"mcpServers": {
"rawtherapee": {
"command": "uvx",
"args": ["rawtherapee-mcp-server"],
"env": {
"RT_CLI_PATH": "C:\\Program Files\\RawTherapee\\5.12\\rawtherapee-cli.exe",
"RT_OUTPUT_DIR": "D:\\Photos\\Processed"
}
}
}
}
```
</details>
<details>
<summary><strong>macOS</strong> (<code>~/Library/Application Support/Claude/claude_desktop_config.json</code>)</summary>
```json
{
"mcpServers": {
"rawtherapee": {
"command": "uvx",
"args": ["rawtherapee-mcp-server"],
"env": {
"RT_OUTPUT_DIR": "/Users/you/Pictures/Processed"
}
}
}
}
```
RawTherapee CLI 在 `/Applications/RawTherapee.app/Contents/MacOS/rawtherapee-cli` 处自动检测。
</details>
<details>
<summary><strong>Linux</strong> (<code>~/.config/Claude/claude_desktop_config.json</code>)</summary>
```json
{
"mcpServers": {
"rawtherapee": {
"command": "uvx",
"args": ["rawtherapee-mcp-server"],
"env": {
"RT_OUTPUT_DIR": "/home/you/Pictures/Processed"
}
}
}
}
```
RawTherapee CLI 在 `/usr/bin/rawtherapee-cli`、`/usr/local/bin/rawtherapee-cli` 或 `/snap/bin/rawtherapee-cli` 处自动检测。
</details>
<details>
<summary><strong>开发（从源码）</strong></summary>
使用 `uv` 从克隆的仓库运行：
```json
{
"mcpServers": {
"rawtherapee": {
"command": "uv",
"args": ["--directory", "/path/to/rawtherapee-mcp-server", "run", "rawtherapee-mcp-server"],
"env": {
"RT_OUTPUT_DIR": "/home/you/Pictures/Processed"
}
}
}
}
```
</details>
### Claude Code
```bash
# 已发布的软件包
claude mcp add rawtherapee -- uvx rawtherapee-mcp-server
# 开发（从源码）
claude mcp add rawtherapee -- uv --directory /path/to/rawtherapee-mcp-server run rawtherapee-mcp
```
### Cursor
添加 `.cursor/mcp.json` 到您的项目：
```json
{
"mcpServers": {
"rawtherapee": {
"command": "uvx",
"args": ["rawtherapee-mcp-server"],
"env": {
"RT_CLI_PATH": "/usr/bin/rawtherapee-cli",
"RT_OUTPUT_DIR": "/home/you/Pictures/Processed"
}
}
}
}
```
### Windsurf
添加您的 Windsurf MCP 配置：
```json
{
"mcpServers": {
"rawtherapee": {
"command": "uvx",
"args": ["rawtherapee-mcp-server"],
"env": {
"RT_CLI_PATH": "/usr/bin/rawtherapee-cli",
"RT_OUTPUT_DIR": "/home/you/Pictures/Processed"
}
}
}
}
```
### Cline（VS Code）
添加您的 Cline MCP 设置：
```json
{
"mcpServers": {
"rawtherapee": {
"command": "uvx",
"args": ["rawtherapee-mcp-server"],
"env": {
"RT_CLI_PATH": "/usr/bin/rawtherapee-cli",
"RT_OUTPUT_DIR": "/home/you/Pictures/Processed"
}
}
}
}
```
> **注意：** Cline 可能无法渲染工具响应中的内联图像。所有基于文本的工具正常工作。
请参阅 [docs/CLIENT_COMPATIBILITY.md](docs/CLIENT_COMPATIBILITY.md) 获取所有客户端的 pip + venv 配置示例。
## 快速入门
安装和客户端配置完成后，请尝试此工作流：
1. **"分析此照片"** - `analyze_image` 读取 EXIF，计算直方图，生成缩略图，并返回处理建议
2. **"使其更暖和并具有更多对比度"** - `generate_pp3_profile` 创建一个具有暖色平衡和对比度增强的配置文件，`preview_before_after` 显示差异
3. **"阴影太暗"** - `add_luminance_adjustment` 添加亮度调整，`preview_with_adjustments` 显示结果
4. **"导出我的手机"** - `process_raw` 使用 `device_preset` 剪辑并处理 RAW 文件
## 更新
两种安装方法都需要两步过程。升级软件包本身是不够的 - Claude Desktop 缓存了 MCP 服务器的工具列表。始终遵循完整序列：更新包 -> 完全退出 Claude Desktop -> 重新启动。
### 使用 uvx
uvx 创建每个包的收据，锁定解析的版本。 `--refresh` 重新下载相同的锁定版本；它不会升级。要获取新版本，请清除收据并更新版本号：
**Windows（http://localhost）：
```powershell
uv cache clean rawtherapee-mcp-server
# 更新版本固定在 %APPDATA%\Claude\claude_desktop_config.json
# 例如更改为 @1.0.5
Get-Process *claude* -ErrorAction SilentlyContinue | Stop-Process -Force
Start-Process "$env:LOCALAPPDATA\AnthropicClaude\Claude.exe"
```
**macOS：**
```bash
uv cache clean rawtherapee-mcp-server
# 更新 ~/Library/Application Support/Claude/claude_desktop_config.json 中的版本固定
osascript -e 'quit app "Claude"' && sleep 2 && open -a Claude
```
**Linux：**
```bash
uv cache clean rawtherapee-mcp-server
# 更新 ~/.config/Claude/claude_desktop_config.json 中的版本固定
pkill -f claude && sleep 2 && claude &
```
### 使用 pip + venv
**Windows：**
```powershell
& "$env:USERPROFILE\.rawtherapee-mcp-env\Scripts\pip.exe" install --upgrade rawtherapee-mcp-server
Get-Process *claude* -ErrorAction SilentlyContinue | Stop-Process -Force
Start-Process "$env:LOCALAPPDATA\AnthropicClaude\Claude.exe"
```
**macOS / Linux：**
```bash
~/.rawtherapee-mcp-env/bin/pip install --upgrade rawtherapee-mcp-server
# macOS:
osascript -e 'quit app "Claude"' && sleep 2 && open -a Claude
# Linux:
pkill -f claude && sleep 2 && claude &
```
### 验证更新是否成功
重启后，请 Claude：
> "当前的 rawtherapee-mcp-server 版本是多少？注册了多少种工具？"
将结果与 [CHANGELOG.md](CHANGELOG.md) 进行比较。如果版本号正确，但缺少新工具，请参阅 [docs/TROUBLESHOOTING.md#stale-tool-list-after-update](docs/TROUBLESHOOTING.md#stale-tool-list-after-update)。
在 [GitHub Releases](https://github.com/lucamarien/rawtherapee-mcp-server/releases) 上查看完整变更日志。
## 可用工具（49）
### 发现与配置（5）
| 工具 | 描述 |
|------|-------------|
| `check_rt_status` | 检查 RawTherapee 安装、版本、CLI 路径和服务器配置 |
| `list_templates` | 列出所有可用的 PP3 模板（内置和自定义） |
| `list_device_presets` | 列出所有设备/格式的裁剪和缩放预设 |
| `list_raw_files` | 扫描目录以查找支持的 RAW 文件 |
| `list_output_files` | 列出输出目录中的已处理文件 |
### 元数据与分析（5）
| 工具 | 描述 |
|------|-------------|
| `read_exif` | 读取 EXIF 元数据并提供结构化的处理建议 |
| `analyze_image` | 一体化分析：EXIF + 直方图 + 缩略图 + 建议 |
| `batch_analyze` | 分析多个图像，提供 EXIF、建议和缩略图 |
| `get_image_info` | 获取尺寸、格式、文件大小，可选内联缩略图 |
| `get_histogram` | RGB 直方图，包含每个通道的统计信息、剪切和 SVG 可视化 |
### 剖面管理（8）
| 工具 | 描述 |
|------|-------------|
| `generate_pp3_profile` | 从基本模板 + 参数 + 设备预设创建 PP3 配置文件 |
| `read_profile` | 以人类可读的格式显示 PP3 配置文件内容 |
| `adjust_profile` | 修改现有配置文件中的特定参数 |
| `compare_profiles` | 差异两个配置文件，可选视觉 A/B 对比 |
| `save_template` | 将配置文件另存为可重用的自定义模板 |
| `create_template_from_description` | 从自然语言描述创建模板存根 |
| `delete_template` | 删除自定义模板 |
| `interpolate_profiles` | 通过线性插值混合两个配置文件 |
### 预览与可视化（7）
| 工具 | 描述 |
|------|-------------|
| `preview_raw` | 快速预览 JPEG，可选内联图像返回 |
| `preview_before_after` | 视觉对比中性 vs. 配置文件 |
| `preview_exposure_bracket` | 多个 EV 档位渲染以进行曝光比较 |
| `preview_white_balance` | 多个白平衡预设，带有开尔文值 |
| `batch_preview` | 多个 RAW 文件的缩略图 |
| `preview_luminance_mask` | 灰度掩码显示局部调整覆盖 |
| `preview_with_adjustments` | 预览所有 Locallab 均处于活动状态 |
### 处理与导出（4）
| 工具 | 描述 |
|------|-------------|
| `process_raw` | 将 RAW 文件处理为 JPEG/TIFF/PNG，带有内联缩略图 |
| `apply_template` | 将模板应用于处理 RAW 文件，可选设备预设 |
| `batch_process` | 使用相同配置文件处理多个 RAW 文件 |
| `export_multi_device` | 导出一个 RAW 文件针对多个设备进行优化，一次调用 |
### 裁剪与设备（3）
| 工具 | 描述 |
|------|-------------|
| `adjust_crop_position` | 重新定位裁剪（左/中/右，上/中/下，或像素偏移） |
| `add_device_preset_tool` | 创建自定义设备预设 |
| `delete_device_preset` | 删除自定义设备预设 |
### 局部调整（5）
| 工具 | 描述 |
|------|-------------|
| `add_luminance_adjustment` | 添加基于亮度的局部调整（阴影/中间色调/高亮/自定义） |
| `list_local_adjustments` | 列出配置文件中的所有 Locallab 斑点 |
| `adjust_local_spot` | 修改现有的 Locallab 斑点 |
| `remove_local_adjustment` | 删除 Locallab 斑点 |
| `apply_local_preset` | 应用预定义的局部调整预设，并可缩放强度 |
### 镜头校正（2）
| 工具 | 描述 |
|------|-------------|
| `apply_lens_correction` | 将 Lensfun 自动检测或 Adobe LCP 校正应用于 PP3 配置文件 |
| `check_lens_support` | 查询 Lensfun 数据库以获取失真/渐晕/横向色差覆盖 |
### 电影模拟 / LUT 支持 (4)
| 工具 | 描述 |
|------|-------------|
| `list_luts` | 扫描 `RT_HALDCLUT_DIR` 中的 HaldCLUT 电影模拟 LUT，按类别分组 |
| `apply_lut` | 将 HaldCLUT 电影模拟写入 PP3 配置文件，可配置强度 |
| `preview_lut` | 渲染带有电影模拟的 RAW 文件的内联预览 |
| `preview_lut_comparison` | 渲染 2-5 个 LUT 预览并排对比 |
### 配置文件继承 (3)
| 工具 | 描述 |
|------|-------------|
| `create_profile_variant` | 从父模板派生子 PP3，并覆盖部分设置 |
| `list_profile_variants` | 列出所有变体及其覆盖设置，可按父模板筛选 |
| `update_base_profile` | 修改基础模板并将更改传播到所有子变体 |
### 元数据隐私 (3)
| 工具 | 描述 |
|------|-------------|
| `inspect_metadata` | 将 JPEG/TIFF EXIF 分类为敏感、技术、权利，并提供隐私建议 |
| `strip_metadata` | 无损移除 JPEG 中的 GPS、序列号、软件和所有者标签 |
| `set_metadata` | 在 JPEG 中写入版权、艺术家、描述和关键词 |
## 内置资源
### PP3 模板 (5)
| 模板 | 描述 |
|----------|-------------|
| `neutral` | 最小处理，相机白平衡，基本锐化 |
| `warm_portrait` | 暖色调（5800K），柔和对比度，皮肤友好饱和度 |
| `moody_cinematic` | 冷色调（5200K），提升阴影，降低饱和度，胶片效果 |
| `vivid_pet` | 暖色调（5600K），增强饱和度和鲜艳度，强锐化 |
| `bw_classic` | 通过通道混合器转换为黑白，高对比度，强锐化 |
### 设备预设 (19)
- **移动设备** (7): 三星 Galaxy S26 Ultra，Galaxy S25 Ultra，iPhone 16 Pro Max，iPhone 16，谷歌 Pixel 9 Pro，通用 9:16，通用 9:19.5
- **桌面设备** (5): 4K UHD (3840x2160)，WQHD (2560x1440)，全高清 (1920x1080)，超宽 21:9 (3440x1440)，双 4K 32:9 (7680x2160)
- **照片格式** (7): 3:2 (35mm)，4:3，16:9，1:1 (方形)，5:4，4:5 (Instagram 肖像)，2:3 (肖像 35mm)
可通过 `add_device_preset_tool` 添加自定义预设，并跨会话保存。
### 本地调整预设 (7)
| 预设 | 描述 |
|--------|-------------|
| `shadow_recovery` | 亮化阴影而不影响高光 |
| `highlight_protection` | 压缩高光以恢复细节 |
| `split_tone_warm_cool` | 暖色阴影，冷色高光 |
| `midtone_contrast` | 仅在中调添加对比度 |
| `shadow_desaturation` | 使阴影区域去饱和以获得干净的外观 |
| `amoled_optimize` | 高对比度和深黑色适用于 AMOLED 显示屏 |
| `hdr_natural` | 自然 HDR 外观，阴影提升，高光压缩 |
预设接受 `intensity` 参数（50 = 默认，25 = 一半，100 = 双倍）。
## 环境变量
| 变量 | 默认值 | 描述 |
|----------|---------|-------------|
| `RT_CLI_PATH` | 自动检测 | `rawtherapee-cli` 二进制文件路径 |
| `RT_OUTPUT_DIR` | `~/Pictures/rawtherapee-mcp-output` | 默认输出目录 |
| `RT_PREVIEW_DIR` | 操作系统临时目录 | 预览图像目录 |
| `RT_CUSTOM_TEMPLATES_DIR` | `./custom_templates` | 自定义 PP3 模板目录 |
| `RT_PREVIEW_MAX_WIDTH` | `1200` | 预览最大宽度（像素） |
| `RT_JPEG_QUALITY` | `95` | 默认 JPEG 质量（1-100） |
| `RT_LOG_LEVEL` | `WARNING` | 日志级别（DEBUG，INFO，WARNING，ERROR） |
参见 [.env.example](.env.example) 以获取文档化的配置模板。
## 已知限制
- **RawTherapee CLI 必须单独安装** — 它不是 Python 包，无法通过 pip 安装
- **仅支持标准输入/输出传输** — 设计用于本地桌面使用，无 HTTP/SSE 服务器模式
- **RT 5.12 裁剪 + 缩放错误** — RawTherapee 5.12 在同一 PP3 配置文件中同时启用裁剪和缩放时，会静默忽略裁剪；服务器会自动应用仅裁剪的变通方法
- **1MB MCP 工具响应限制** — 预览分辨率受到管理，以保持在 Claude Desktop 的响应大小限制内
- **无像素级编辑** — 无修饰、对象移除、频率分离或内容感知填充
- **无多图像合成** — 无 HDR 合并、拼图拼接或对焦堆叠
- **亮度掩模仅限色调** — 无空间或主题感知掩模
- 集成测试需要 RawTherapee 安装，默认跳过
## 故障排除
**RawTherapee 未找到：**
- 运行 `check_rt_status` 以查看检测详细信息
- 将 `RT_CLI_PATH` 设置为 `rawtherapee-cli` 的完整路径：
- Windows: `C:\Program Files\RawTherapee\5.12\rawtherapee-cli.exe`
- macOS: `/Applications/RawTherapee.app/Contents/MacOS/rawtherapee-cli`
- Linux: `/usr/bin/rawtherapee-cli`
**Windows 上带有空格的路径：**
- 在 `RT_CLI_PATH` 中始终使用完整路径，包括引号（如果 shell 需要）
- MCP 客户端配置文件 JSON 中的环境变量不需要额外转义
**预览图像太大：**
- 减少 `RT_PREVIEW_MAX_WIDTH`（默认：1200）
- 预览工具自动缩略以保持在 1MB 响应限制内
**服务器无响应：**
- 验证 MCP 客户端配置文件中的条目是否正确
- 在配置文件更改后重启 MCP 客户端
- 将 `RT_LOG_LEVEL=DEBUG` 设置为 stderr 上查看详细日志
**新版本已安装，但旧工具仍在 Claude 中显示：**
参见 [docs/TROUBLESHOOTING.md - 更新后工具列表仍旧](docs/TROUBLESHOOTING.md#stale-tool-list-after-update)。简版：完全退出 Claude Desktop（它作为后台进程运行），然后重新启动。
## Docker
```bash
docker build -t rawtherapee-mcp-server .
docker run -i --rm \
-v /path/to/photos:/photos \
-v /path/to/output:/output \
-e RT_OUTPUT_DIR=/output \
rawtherapee-mcp-server
```
## 开发
参见 [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) 以获取完整的设置说明。
```bash
git clone https://github.com/lucamarien/rawtherapee-mcp-server
cd rawtherapee-mcp-server
pip install -e ".[dev]"
make validate # lint + format + typecheck + test + security + audit
```
### 测试
```bash
# 单元测试（模拟，无需 RawTherapee）
pytest -v
# 集成测试（需要 RawTherapee 安装）
pytest -m integration -v
```
### MCP 检验器
```bash
npx @modelcontextprotocol/inspector uv run rawtherapee-mcp
```
## 贡献
参见 [CONTRIBUTING.md](CONTRIBUTING.md) 以获取开发指南、编码标准和 PR 检查清单。
## 许可证
[MIT](LICENSE)
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器