Samsung Stremio Spotify MCP

Tu asistente personal de visualización para Samsung TV

Dile lo que quieres ver. Encuentra el episodio correcto, lo inicia en tu TV, recuerda dónde te detuviste y mantiene tu velada en movimiento.

Puedes preguntar de forma natural:

"¿Qué episodios nuevos puedo ver?"

"Continúa la serie que estaba viendo."

"Créame una cola con estos tres episodios, en este orden."

"Detente después de este episodio."

El proyecto reúne tu biblioteca de Stremio, tu Samsung TV, Spotify y el historial opcional de Trakt en una sola conversación. Tú decides qué quieres ver o escuchar; el asistente se encarga de los pasos que lo rodean.

Related MCP server: Arr Suite MCP Server

Lo que cambia en la forma de ver la televisión

Siéntate y continúa

No necesitas recordar la temporada, el episodio ni la marca de tiempo. Pide continuar una serie y el asistente puede reanudar un episodio visto parcialmente o sugerir el siguiente no visto.

Sepa qué está realmente listo para ver

Pregunta qué hay de nuevo y obtén episodios estrenados y no vistos de tu propia biblioteca que actualmente tengan una fuente reproducible. La respuesta trata sobre lo que puedes ver ahora, no solo lo que apareció en un calendario de estrenos.

Planifica una noche entera en una frase

Crea una cola ordenada manualmente con diferentes series. Elige qué se reproduce primero, qué sigue y dónde termina la noche. La cola se guarda localmente y avanza a medida que terminan los episodios.

Deja que un maratón fluya de forma natural

Cuando pides explícitamente ver una serie en maratón, el siguiente episodio no visto puede comenzar automáticamente. Si dices "detente después de este episodio" o apagas la TV, el asistente respeta ese límite.

Obtén una buena transmisión sin estudiar los nombres de los lanzamientos

El asistente considera la disponibilidad, la calidad, el tamaño del archivo, la compatibilidad de video y audio, la salud de los seeds, el idioma y las pistas de subtítulos. Valida la fuente seleccionada y puede probar otro candidato si uno falla.

Mantén útil tu historial de visualización

El progreso real de reproducción de la TV se guarda de nuevo en Stremio. Los episodios parciales se pueden reanudar más tarde, y los episodios completados se marcan como vistos en el umbral normal de finalización. El scrobbling de Trakt se puede añadir sin convertirlo en un requisito para la reproducción.

Controla el resto de la sala

La misma conversación puede abrir Spotify en la TV, encontrar música, crear una cola de artista sin interrumpir la canción actual, controlar la reproducción o ajustar el volumen de la TV.

Una noche típica

1. Pregunta: "¿Qué episodios nuevos puedo ver?"

2. Elige un episodio o organiza varias series en una cola.

3. El asistente encuentra una fuente compatible y la inicia en el Samsung TV.

4. El progreso de reproducción se supervisa mientras miras.

5. Si te detienes antes, se guarda tu posición. Si terminas, se actualiza tu estado de visualización.

6. En modo maratón o cola, la noche continúa según el orden que elegiste.

Cosas que puedes preguntar

• Play season [season] episode [episode] of [show].

• Continue the show I was watching.

• Binge this show.

• Stop after this episode.

• Create a queue with these episodes, in this order.

• Skip this queue item.

• What new episodes can I watch?

• Mark the episode I just finished as watched.

• Play songs by [artist] without interrupting the current song.

• Set the TV volume to [level].

Construido en torno a tus elecciones

Las integraciones son independientes:

• Usa Stremio sin Spotify o Trakt.

• Usa Spotify sin conectar Stremio.

• Añade Trakt solo si quieres scrobbling.

• Usa los controles de TV sin configurar una cuenta de medios.

Las credenciales, el estado de reproducción, las colas y la información de emparejamiento permanecen en tu computadora. El servicio HTTP y el addon local de Stremio escuchan solo en la máquina local.

Soporte actual

Samsung sigue siendo el respaldo universal y conserva sus controles nativos de encendido, volumen, lanzamiento de aplicaciones, reproducción DLNA y telemetría. Los receptores Google Cast guardados, como Cellcom Master Boxes, también se pueden seleccionar explícitamente o asignarse como predeterminados para una huella de red.

La precedencia de destino es:

1. Un target explícito en una solicitud de reproducción de Stremio.

2. El destino guardado para la huella de red actual.

3. Samsung.

Los mapeos de red y las identidades de los receptores viven en el directorio de estado local como media-devices.json; no se comprometen al proyecto.

Spotify y Trakt son opcionales. La reproducción de Stremio requiere una cuenta de Stremio vinculada, addons de transmisión adecuados y un Samsung TV accesible.

Requisitos

• Node.js 20 o más reciente

• Un Samsung Smart TV accesible desde la misma red local

• Una instalación local funcional de SamsungTVControl para emparejamiento, encendido y teclas remotas

• Stremio con los addons de transmisión deseados instalados

• Una aplicación de desarrollador de Spotify para las funciones de Spotify

• Una aplicación de API de Trakt para el scrobbling opcional

Instalar

git clone https://github.com/dudibuilds/samsung-stremio-spotify-mcp.git
cd samsung-stremio-spotify-mcp
npm install
npm run init-config

Las credenciales y el estado local se crean en:

%USERPROFILE%\.samsung-spotify-tv\

Se conserva el nombre del directorio heredado para que las instalaciones existentes sigan funcionando.

Conectar un cliente MCP

El servidor usa stdio por defecto. Apunta el cliente MCP a la ruta absoluta de server/index.mjs:

{
  "mcpServers": {
    "samsung-stremio-spotify": {
      "command": "node",
      "args": [
        "C:\\absolute\\path\\to\\samsung-stremio-spotify-mcp\\server\\index.mjs"
      ]
    }
  }
}

Reinicia el cliente MCP después de cambiar su configuración.

Vincular Stremio

1. Llama a integration_auth con provider: "stremio" y action: "start".

2. Abre y aprueba el enlace devuelto.

3. Llama a integration_auth con provider: "stremio" y action: "complete".

Conectar Spotify

1. Crea una aplicación de desarrollador de Spotify.

2. Añade http://127.0.0.1:18765/callback como URI de redirección.

3. Completa %USERPROFILE%\.samsung-spotify-tv\spotify-credentials.json.

4. Ejecuta npm run auth.

Conectar Trakt (opcional)

1. Crea una aplicación de API de Trakt.

2. Completa %USERPROFILE%\.samsung-spotify-tv\trakt-credentials.json.

3. Llama a integration_auth con provider: "trakt" y action: "start".

4. Aprueba el código mostrado y luego usa action: "complete".

Ejecutar el servicio HTTP opcional

npm run mcp:http

El endpoint MCP es http://127.0.0.1:4512/mcp.

Instalar el addon local Cast to TV

Con el servicio HTTP en ejecución, instala esta URL en Stremio de escritorio:

http://127.0.0.1:4512/stremio-cast/manifest.json

Esto añade opciones de Cast to TV dentro de Stremio. La opción automática usa el mapeo de red actual y luego recurre a Samsung; los destinos Samsung y Google Cast con nombre también se enumeran explícitamente.

Anulaciones de entorno

Consulta .env.example para anulaciones opcionales de ruta, nombre de dispositivo, servidor Stremio, host y puerto. Nunca coloques credenciales reales en .env.example ni confirmes un archivo de entorno poblado.

La versión 0.2.1 expone nueve herramientas orientadas al dominio:

Cada acción valida solo los parámetros relevantes para esa acción. Los errores contienen tool, action, code y message.

Migración a la versión 0.2

La versión 0.2 es un cambio brusco de la API de herramientas. stremio_queue conserva su nombre y contrato. stremio_library conserva su nombre pero ahora requiere una acción de mutación; el listado de biblioteca se movió a stremio_discover. Otros nombres de herramientas de la 0.1 ya no se anuncian ni se aceptan.

Comportamiento de reproducción

• Las solicitudes explícitas de temporada y episodio se reproducen inmediatamente.

• Los títulos de series sin especificar proponen reanudar o iniciar el siguiente episodio no visto.

• La reproducción se marca como vista al 90% de finalización.

• El estado de la cola y el progreso parcial se guardan localmente.

• Apagar la TV finaliza la sesión y detiene el avance automático.

• Las fuentes fallidas permiten intentar con el siguiente candidato clasificado.

Componentes principales

Validación

npm run smoke
npm run mcp:smoke
npm audit --omit=dev

Las pruebas usan estado temporal y bloquean el acceso a TV en vivo y a redes externas.

Seguridad

Este software controla un televisor físico y utiliza cuentas de medios autenticadas. Mantén las credenciales, los tokens de emparejamiento, el estado de ejecución y los registros fuera de Git. No expongas el MCP HTTP ni el addon local a la LAN o a Internet. Consulta SECURITY.md.

Licencia

MIT. Consulta LICENSE.