Immich Photo Manager

Name: Immich Photo Manager
Author: Drolosoft

Drolosoft

Manages a self-hosted Immich library: CLIP and OCR search, geographic albums, duplicates, people and faces, metadata repair and photobooks.

接入配置

选择客户端，复制配置，再按项目文档补齐环境变量。

一键添加到 Cursor 一键添加到 VS Code

claude mcp add immich-photo-manager --env IMMICH_BASE_URL='<IMMICH_BASE_URL>' --env IMMICH_API_KEY='<IMMICH_API_KEY>' --env PYTHONPATH='<PYTHONPATH>' --env MCP_TRANSPORT='<MCP_TRANSPORT>' -- uvx immich-photo-manager

~/.codex/config.toml

[mcp_servers.immich-photo-manager]
command = "uvx"
args = ["immich-photo-manager"]
env = { IMMICH_BASE_URL = "<IMMICH_BASE_URL>", IMMICH_API_KEY = "<IMMICH_API_KEY>", PYTHONPATH = "<PYTHONPATH>", MCP_TRANSPORT = "<MCP_TRANSPORT>" }

# codex mcp add immich-photo-manager --env IMMICH_BASE_URL='<IMMICH_BASE_URL>' --env IMMICH_API_KEY='<IMMICH_API_KEY>' --env PYTHONPATH='<PYTHONPATH>' --env MCP_TRANSPORT='<MCP_TRANSPORT>' -- uvx immich-photo-manager

~/.cursor/mcp.json

{
  "mcpServers": {
    "immich-photo-manager": {
      "command": "uvx",
      "args": [
        "immich-photo-manager"
      ],
      "env": {
        "IMMICH_BASE_URL": "<IMMICH_BASE_URL>",
        "IMMICH_API_KEY": "<IMMICH_API_KEY>",
        "PYTHONPATH": "<PYTHONPATH>",
        "MCP_TRANSPORT": "<MCP_TRANSPORT>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "immich-photo-manager": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "immich-photo-manager"
      ],
      "env": {
        "IMMICH_BASE_URL": "<IMMICH_BASE_URL>",
        "IMMICH_API_KEY": "<IMMICH_API_KEY>",
        "PYTHONPATH": "<PYTHONPATH>",
        "MCP_TRANSPORT": "<MCP_TRANSPORT>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "immich-photo-manager": {
      "command": "uvx",
      "args": [
        "immich-photo-manager"
      ],
      "env": {
        "IMMICH_BASE_URL": "<IMMICH_BASE_URL>",
        "IMMICH_API_KEY": "<IMMICH_API_KEY>",
        "PYTHONPATH": "<PYTHONPATH>",
        "MCP_TRANSPORT": "<MCP_TRANSPORT>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "immich-photo-manager": {
      "command": "uvx",
      "args": [
        "immich-photo-manager"
      ],
      "env": {
        "IMMICH_BASE_URL": "<IMMICH_BASE_URL>",
        "IMMICH_API_KEY": "<IMMICH_API_KEY>",
        "PYTHONPATH": "<PYTHONPATH>",
        "MCP_TRANSPORT": "<MCP_TRANSPORT>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "immich-photo-manager": {
      "command": "uvx",
      "args": [
        "immich-photo-manager"
      ],
      "env": {
        "IMMICH_BASE_URL": "<IMMICH_BASE_URL>",
        "IMMICH_API_KEY": "<IMMICH_API_KEY>",
        "PYTHONPATH": "<PYTHONPATH>",
        "MCP_TRANSPORT": "<MCP_TRANSPORT>"
      }
    }
  }
}

需要的环境变量

IMMICH_BASE_URL
IMMICH_API_KEY
PYTHONPATH
MCP_TRANSPORT

把占位值换成你自己的密钥；不要把密钥提交到代码仓库。

接入配置

需要的环境变量

相关推荐