Repository navigation
Releases
synology-mcp 0.14.0
English
Synology Photos:
photos_list: find photos and videos by album, person, place, tag, dates or text. Each one comes with its NAS path, so Claude can open it withread_file.photos_browse: places, people or tags, with how many photos each has.photos_albums,photos_create_album,photos_album_items,photos_delete_album: list albums, create them, add or remove photos, delete them (the photos stay).- Works on the shared space (
/photo, the default) and your personal one (/home/Photos).
Also new:
package_control: start or stop a package. It won't stop system packages or start broken ones.drive_update_file_request: change, close or reopen a Drive file request.- Two NAS from the plugin or the extension: the form now has fields for a second NAS (its password goes to the keychain), and a field for a JSON file with more.
Tested against a real DS218+ (DSM 7.4.1). 98 tools (52 in read-only mode).
Update: claude plugin update synology@synology-mcp, or install the new .mcpb in Claude Desktop.
Español
Synology Photos:
photos_list: buscar fotos y vídeos por álbum, persona, lugar, etiqueta, fechas o texto. Cada uno viene con su ruta en el NAS, así que Claude puede abrirlo conread_file.photos_browse: lugares, personas o etiquetas, con cuántas fotos tiene cada uno.photos_albums,photos_create_album,photos_album_items,photos_delete_album: ver álbumes, crearlos, añadir o quitar fotos, borrarlos (las fotos se quedan).- Funciona en el espacio compartido (
/photo, el de por defecto) y en el personal (/home/Photos).
También nuevo:
package_control: arrancar o parar un paquete. No para los del sistema ni arranca los averiados.drive_update_file_request: cambiar, cerrar o reabrir una file request de Drive.- Dos NAS desde el plugin o la extensión: el formulario tiene ahora campos para un segundo NAS (su contraseña va al llavero) y un campo para un fichero JSON con más.
Probado contra un DS218+ real (DSM 7.4.1). 98 herramientas (52 en solo lectura).
Actualizar: claude plugin update synology@synology-mcp, o instalar el nuevo .mcpb en Claude Desktop.
synology-mcp 0.13.0
English
Installed packages (admin only):
get_packages: installed packages and their status. Broken ones come first, with what to do (e.g. "incompatible with this DSM version: update or repair it"). It also warns if Hyper Backup is not installed.
Synology Drive sharing:
drive_share: give, change or remove a user's or group's role (viewer, commenter, editor, manager…).drive_link: turn the sharing link on for NAS users or for anyone, or off. With a password or an expiry date it creates a protected link.drive_file_requests,drive_create_file_request,drive_delete_file_request: upload links so people without a NAS account can send you files.- If Drive doesn't allow public links or file requests, the error says so and where to enable them.
Fixed: changing a link from internal to public could leave the file without any link when the NAS refused the public one; the previous link is now restored.
Tested against a real DS218+ (DSM 7.4.1) in temporary folders. 90 tools (49 in read-only mode).
Update: claude plugin update synology@synology-mcp, or install the new .mcpb in Claude Desktop.
Español
Paquetes instalados (solo admin):
get_packages: paquetes instalados y su estado. Los averiados salen primero, con qué hacer (por ejemplo, "no es compatible con esta versión de DSM: actualízalo o repáralo"). También avisa si Hyper Backup no está instalado.
Compartir en Synology Drive:
drive_share: dar, cambiar o quitar el rol de un usuario o grupo (lector, comentarista, editor, gestor…).drive_link: activar el enlace para usuarios del NAS o para cualquiera, o quitarlo. Con contraseña o fecha de caducidad crea un enlace protegido.drive_file_requests,drive_create_file_request,drive_delete_file_request: enlaces de subida para que gente sin cuenta en el NAS te envíe ficheros.- Si Drive no permite enlaces públicos o file requests, el error lo dice y explica dónde activarlos.
Arreglado: cambiar un enlace de interno a público podía dejar el fichero sin ningún enlace si el NAS rechazaba el público; ahora se restaura el anterior.
Probado contra un DS218+ real (DSM 7.4.1) en carpetas temporales. 90 herramientas (49 en solo lectura).
Actualizar: claude plugin update synology@synology-mcp, o instalar el nuevo .mcpb en Claude Desktop.
synology-mcp 0.12.0
English
Download Station:
downloads_search: search torrents with Download Station's search engines. Results are sorted by seeds and ready fordownloads_add.downloads_set_limits: speed limits per protocol (KB/s) and how many downloads run at once.downloads_set_schedule: weekly schedule in plain rules, e.g. "on weekdays, don't download from 8 to 23". Each hour runs at full speed, limited or paused.downloads_infonow also shows the queue and the schedule.
User management (admin only, asks for confirmation):
dsm_create_user: create a user with groups. Without a password it generates one and shows it only once.dsm_update_user: change description, groups or password, or disable/enable the account.dsm_delete_user: delete users (DSM also deletes their home folder).- Safeguards: it won't disable, demote or delete the account the MCP uses, nor delete
adminorguest.
Tested against a real DS218+ (DSM 7.4.1), including a throwaway user that was created, signed in, changed, disabled and deleted. 84 tools (47 in read-only mode).
Update: claude plugin update synology@synology-mcp, or install the new .mcpb in Claude Desktop.
Español
Download Station:
downloads_search: buscar torrents con los motores de búsqueda de Download Station. Los resultados salen ordenados por semillas y listos paradownloads_add.downloads_set_limits: límites de velocidad por protocolo (KB/s) y cuántas descargas van a la vez.downloads_set_schedule: horario semanal con reglas sencillas, por ejemplo "entre semana, no descargues de 8 a 23". Cada hora va a toda velocidad, limitada o en pausa.downloads_infoenseña además la cola y el horario.
Gestión de usuarios (solo admin, pide confirmación):
dsm_create_user: crear un usuario con sus grupos. Sin contraseña genera una y la enseña una sola vez.dsm_update_user: cambiar descripción, grupos o contraseña, o desactivar/activar la cuenta.dsm_delete_user: borrar usuarios (DSM borra también su carpeta personal).- Salvaguardas: no desactiva, quita de administradores ni borra la cuenta que usa el MCP, ni borra
adminoguest.
Probado contra un DS218+ real (DSM 7.4.1), incluido un usuario desechable que se creó, entró, se cambió, se desactivó y se borró. 84 herramientas (47 en solo lectura).
Actualizar: claude plugin update synology@synology-mcp, o instalar el nuevo .mcpb en Claude Desktop.
synology-mcp 0.11.0
English
DSM administration (admin only):
dsm_usersanddsm_groups: users, status, administrators and groups.dsm_shared_foldersanddsm_user_access: shared folders and who can access each one.dsm_scheduled_tasks: scheduled tasks and their last result. Scripts are shown without passwords.dsm_services: active services, with warnings about insecure settings (SMB1, plain FTP, Telnet, no HTTPS…).- With writes enabled:
dsm_set_task_enabled,dsm_run_taskanddsm_set_share_access, which ask for confirmation.
New README: banner, badges, an example conversation and quick install. Now in English, with the Spanish version in README.es.md.
Update: claude plugin update synology@synology-mcp, or install the new .mcpb in Claude Desktop.
Español
Administración de DSM (solo admin):
dsm_usersydsm_groups: usuarios, estado, administradores y grupos.dsm_shared_foldersydsm_user_access: carpetas compartidas y quién puede entrar a cada una.dsm_scheduled_tasks: tareas programadas y su último resultado. Los scripts salen sin contraseñas.dsm_services: servicios activos, con avisos de lo inseguro (SMB1, FTP sin cifrar, Telnet, sin HTTPS…).- Con escritura activada:
dsm_set_task_enabled,dsm_run_taskydsm_set_share_access, que piden confirmación.
README nuevo: banner, distintivos, una conversación de ejemplo e instalación rápida.
Actualizar: claude plugin update synology@synology-mcp, o instalar el nuevo .mcpb en Claude Desktop.
synology-mcp 0.10.0
QuickConnect: pon quickconnect:<tu ID> como URL del NAS y funciona desde cualquier sitio, sin abrir puertos. El MCP prueba la red local, la conexión directa y el relé de Synology, y usa la primera que responde. Todas con certificado válido.
Varios NAS (instalación manual): SYNOLOGY_NAS_FILE con una lista de NAS, y las herramientas list_nas y use_nas para ver y cambiar el NAS activo.
Actualizar: claude plugin update synology@synology-mcp, o instalar el nuevo .mcpb en Claude Desktop.
synology-mcp 0.9.0
Liberar espacio (solo admin):
recycle_bins: cuánto ocupa cada papelera.empty_recycle_bin: vaciarlas. Permanente; pide confirmación.docker_remove_images: borrar imágenes de Docker que no usa ningún contenedor.
Download Station:
downloads_listdetecta las descargas muertas (stalled: activas, pero sin velocidad ni pares).downloads_filesydownloads_set_files: elegir qué ficheros de un torrent bajar y su prioridad.- RSS:
downloads_rss,downloads_rss_add,downloads_rss_refreshydownloads_rss_delete. downloads_addadmiteunzip_password.
README reescrito: requisitos, qué permite cada tipo de cuenta, instalación, seguridad, las 69 herramientas por áreas, ejemplos y problemas frecuentes.
Actualizar: claude plugin update synology@synology-mcp, o instalar el nuevo .mcpb en Claude Desktop.
synology-mcp 0.8.0
Container Manager (Docker). Necesita una cuenta administradora.
docker_list: contenedores con estado, salud, proyecto Compose y CPU/memoria en vivo.docker_get: puertos, volúmenes, redes, política de reinicio y último health check. De las variables de entorno solo da los nombres, nunca los valores (suelen ser contraseñas).docker_logs: registro de un contenedor, con filtros por texto y fecha.docker_images: imágenes, tamaño, si se usan y si hay actualización.docker_start,docker_stopydocker_restart, solo con escritura activada. Parar y reiniciar piden confirmación.
Actualizar: claude plugin update synology@synology-mcp, o instalar el nuevo .mcpb en Claude Desktop.
synology-mcp 0.7.0
Salud del NAS: cuatro herramientas nuevas de solo lectura, que necesitan una cuenta administradora.
get_disk_health: SMART de cada disco, con sectores defectuosos y si van en aumento, horas encendido, temperatura y los atributos que fallan.check_updates: si hay actualización de DSM (y si es de seguridad) y qué paquetes tienen versión nueva. Solo consulta, no instala.get_notifications: las notificaciones del escritorio de DSM.get_system_logs: registros del sistema o de conexiones, con filtros por nivel, texto y fecha.
get_system_info incluye además el veredicto de Salud del sistema de DSM.
Actualizar: claude plugin update synology@synology-mcp, o instalar el nuevo .mcpb en Claude Desktop.
synology-mcp 0.6.2
Corrige los estados de Download Station: la 0.6.1 traducía mal los estados numéricos (una descarga compartiéndose salía como filehosting_waiting). Ahora se usa la tabla de la propia interfaz de Download Station, y los errores numéricos salen como error con su causa.
Actualizar: claude plugin update synology@synology-mcp, o instalar el nuevo .mcpb en Claude Desktop.
synology-mcp 0.6.1
Corrección de Download Station.
- Seguridad:
downloads_getmostraba la clave privada (passkey) de los trackers privados en las URL. Ahora se oculta, igual que las credenciales de las URL de origen y los trackers dentro de enlaces magnet. - El estado de una descarga sale siempre por nombre: la API a veces lo da como número (
6en vez dehash_checking).
Actualizar: claude plugin update synology@synology-mcp en Claude Code, o instalar el nuevo .mcpb en Claude Desktop.