Immich Photo Manager — MCP-сервер для Claude Code: функции и установка
Сервер подключает ИИ-агента к вашей библиотеке Immich: он ищет фотографии, помогает разбирать альбомы и находить дубликаты.
claude mcp add --env IMMICH_BASE_URL=<IMMICH_BASE_URL> --env IMMICH_API_KEY=<IMMICH_API_KEY> --env MCP_ALLOWED_HOSTS=<MCP_ALLOWED_HOSTS> --transport stdio immich-photo-manager -- uvx immich-photo-managerЧто делает Immich Photo Manager
Immich Photo Manager даёт агенту доступ к библиотеке Immich через её API. Можно искать снимки, организовывать фотографии, находить дубликаты и подбирать кадры для альбомов. В описании также указаны поиск по лицам и создание PDF-отчётов; всего доступно 94 инструмента.
Сервер рассчитан на собственный экземпляр Immich и работает с Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline и Zed. Для подключения нужны работающий сервер Immich и API-ключ: без них агент не сможет обратиться к библиотеке. Установка для Claude Code запускает сервер через uvx и передаёт адрес Immich и ключ через переменные окружения.
Какие задачи решает
- найти фотографии по запросу
- разобрать снимки по альбомам
- обнаружить дубликаты в библиотеке
- подобрать кадры для альбома
- подготовить PDF-отчёт о фотографиях
Примеры запросов агенту
- Найди в моей библиотеке Immich фотографии с поездки и собери их в альбом.
- Проверь библиотеку Immich на дубликаты фотографий.
- Подготовь PDF-отчёт по фотографиям из альбома.
Как установить Immich Photo Manager
Командой платформы
claude mcp add --env IMMICH_BASE_URL=<IMMICH_BASE_URL> --env IMMICH_API_KEY=<IMMICH_API_KEY> --env MCP_ALLOWED_HOSTS=<MCP_ALLOWED_HOSTS> --transport stdio immich-photo-manager -- uvx immich-photo-managerВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from immich-photo-manager <команда>
Командой платформы
codex mcp add immich-photo-manager --env IMMICH_BASE_URL=<IMMICH_BASE_URL> --env IMMICH_API_KEY=<IMMICH_API_KEY> --env MCP_ALLOWED_HOSTS=<MCP_ALLOWED_HOSTS> -- uvx immich-photo-managerВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from immich-photo-manager <команда>
Файл настроек
{
"mcpServers": {
"immich-photo-manager": {
"command": "uvx",
"args": [
"immich-photo-manager"
],
"env": {
"IMMICH_BASE_URL": "<IMMICH_BASE_URL>",
"IMMICH_API_KEY": "<IMMICH_API_KEY>",
"MCP_ALLOWED_HOSTS": "<MCP_ALLOWED_HOSTS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from immich-photo-manager <команда>
Файл настроек
{
"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>",
"MCP_ALLOWED_HOSTS": "<MCP_ALLOWED_HOSTS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from immich-photo-manager <команда>
Командой платформы
gemini mcp add -e IMMICH_BASE_URL=<IMMICH_BASE_URL> -e IMMICH_API_KEY=<IMMICH_API_KEY> -e MCP_ALLOWED_HOSTS=<MCP_ALLOWED_HOSTS> immich-photo-manager uvx immich-photo-managerВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from immich-photo-manager <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Immich Photo Manager
Как установить Immich Photo Manager в Claude Code?
Добавьте сервер командой claude mcp add immich-photo-manager -e IMMICH_BASE_URL=<IMMICH_BASE_URL> -e IMMICH_API_KEY=<IMMICH_API_KEY> -- uvx immich-photo-manager. Укажите адрес работающего Immich и его API-ключ.
Что делает Immich Photo Manager?
Он подключает ИИ-агента к Immich, чтобы искать и упорядочивать фотографии, находить дубликаты и работать с альбомами. В наборе 94 инструмента.
Что нужно для работы сервера?
Нужен работающий экземпляр Immich и API-ключ. Сервер обращается к библиотеке через API Immich.
