# Immich Photo Manager

Сервер подключает ИИ-агента к вашей библиотеке Immich: он ищет фотографии, помогает разбирать альбомы и находить дубликаты.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 59
- Автор: drolosoft
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/drolosoft/immich-photo-manager
- Обновлён: 2026-10-06
- HTML: https://affpapa.org/nevibecode/mcp/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 и ключ через переменные окружения.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `IMMICH_BASE_URL`, `IMMICH_API_KEY`, `MCP_ALLOWED_HOSTS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```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>",
                "MCP_ALLOWED_HOSTS": "<MCP_ALLOWED_HOSTS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from immich-photo-manager <команда>

### Gemini CLI

**Командой платформы**
```bash
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 <команда>

## Когда брать
- найти фотографии по запросу
- разобрать снимки по альбомам
- обнаружить дубликаты в библиотеке
- подобрать кадры для альбома
- подготовить PDF-отчёт о фотографиях

## Примеры запросов агенту
- Найди в моей библиотеке Immich фотографии с поездки и собери их в альбом.
- Проверь библиотеку Immich на дубликаты фотографий.
- Подготовь PDF-отчёт по фотографиям из альбома.

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16717
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40409
- [dbx](https://affpapa.org/nevibecode/mcp/dbx.md) — MCP-сервер · ★ 27669
- [Metabase](https://affpapa.org/nevibecode/mcp/metabase.md) — MCP-сервер · ★ 49845

Из того же набора: [drolosoft/immich-photo-manager](https://affpapa.org/nevibecode/by/drolosoft/immich-photo-manager.md) — 2 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md