immich-mcp
Servidor MCP (Model Context Protocol) industrializado basado en FastMCP 3.4 para automatización de bibliotecas fotográficas en self-hosted Immich v2.x y v3.x. Proporciona gestión conversacional de activos mediante herramientas nativas para búsqueda CLIP, OCR multilingüe con bounding boxes, administr
Ficha actualizada 28 sept 2026, 20:56 · upstream 28 sept 2026, 20:26 · release sin release detectada
Qué es immich-mcp
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Immich-MCP es un servidor MCP industrializado construido sobre FastMCP 3.4 que proporciona una interfaz conversacional para gestionar bibliotecas fotográficas en servidores Immich auto-alojados (v2.x y v3.x). El proyecto destaca por su enfoque 'Austrian Efficiency' con código estabilizado mediante Biome, linting con Ruff y compatibilidad verificada contra las especificaciones OpenAPI oficiales de Immich.
El servidor expone herramientas para operaciones core: subida de fotos/videos con preservación de metadatos, búsqueda inteligente usando CLIP con consultas en lenguaje natural, extracción OCR multilingüe (soporta griego, coreano, ruso, tailandés y otros) con bounding boxes precisos, gestión de álbumes, recuperación de metadatos detallados incluyendo datos OCR, administración de bibliotecas externas desde v2.4.0+, soporte multiusuario con cambio de usuario y permisos, y descarga de activos a directorio temporal para edición local.
La integración es nativa con Cursor y Claude Desktop mediante protocolo MCP. Soporta múltiples proveedores LLM (OpenAI, Anthropic, Ollama) para capacidades avanzadas como detección de objetos, reconocimiento facial y etiquetado automático cuando el servidor Immich tiene machine learning habilitado.
- Búsqueda conversacional de fotos usando lenguaje natural: 'encuentra fotos de mi perro jugando' con backend CLIP
- Extracción de texto multilingüe de imágenes con bounding boxes para localización precisa del texto
- Gestión automática de álbumes por fecha, ubicación o criterios personalizados
- Sincronización bidireccional: leer metadatos EXIF desde Immich y escribirlos en archivos locales
- Descarga de activos originales a directorio temporal para edición con software local como GIMP
- FastMCP 3.4 industrializado con código estabilizado mediante Biome y linting Ruff sin errores
- OCR multilingüe avanzado con soporte para griego, coreano, ruso, tailandés y otros idiomas
- Compatibilidad verificada contra especificaciones OpenAPI oficiales de Immich v2.7.5, v3.0.3 y v3.1.0
- Integración nativa con Cursor y Claude Desktop mediante protocolo MCP sin configuración compleja
- Soporte multiusuario con cambio de usuario y permisos desde v2.4.0+
- Detección automática de características por versión de Immich (v2.3.x, v2.4.0+, etc.)
- Requiere servidor Immich self-hosted con API key configurada en Administration > API Keys
- Funciones LLM avanzadas requieren Immich v2.2.0+ con machine learning habilitado y recursos adicionales
- Algunas operaciones destructivas (eliminar, fusionar) requieren confirmación explícita por llamada
- Dependencia de uv recomendado para gestión de dependencias aunque soporta pip directo
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar vía pip: pip install immich-mcp. Configurar en MCP client con IMMICH_SERVER_URL y IMMICH_API_KEY. Alternativa rápida: uvx immich-mcp. Para Cursor, añadir a ~/.cursor/mcp.json con PYTHONPATH apuntando al repo clonado. Para LLM features, configurar machine_learning en Immich Administration > Settings > Machine Learning con proveedor Ollama o cloud.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.