Samsung Stremio Spotify MCP

Ваш персональный помощник по просмотру для Samsung TV

Расскажите ему, что хотите посмотреть. Он находит нужный эпизод, запускает его на вашем телевизоре, запоминает, где вы остановились, и поддерживает ход вашего вечера.

Вы можете спросить естественно:

«Какие новые эпизоды я могу посмотреть?»

«Продолжить шоу, которое я смотрел.»

«Собери мне очередь из этих трёх эпизодов в таком порядке.»

«Остановиться после этого эпизода.»

Проект объединяет вашу библиотеку Stremio, Samsung TV, Spotify и, при желании, историю Trakt в один разговор. Вы решаете, что хотите смотреть или слушать, а помощник берёт на себя все сопутствующие шаги.

Related MCP server: Arr Suite MCP Server

Что меняется в просмотре телевизора

Садитесь и продолжайте

Вам не нужно помнить сезон, эпизод или таймкод. Попросите продолжить шоу, и помощник сможет возобновить частично просмотренный эпизод или предложить следующий непросмотренный.

Знайте, что действительно готово к просмотру

Спросите, что нового, и получите вышедшие, непросмотренные эпизоды из вашей библиотеки, для которых в данный момент есть доступный источник. Ответ касается того, что вы можете посмотреть сейчас, а не просто того, что появилось в календаре релизов.

Спланируйте весь вечер одной фразой

Создайте вручную упорядоченную очередь из разных шоу. Выберите, что будет играть первым, что дальше, и где закончится вечер. Очередь сохраняется локально и продвигается по мере завершения эпизодов.

Позвольте марафону идти естественно

Когда вы явно просите устроить марафон, следующий непросмотренный эпизод может начаться автоматически. Если вы скажете «остановиться после этого эпизода» или выключите телевизор, помощник уважает эту границу.

Получите хороший поток, не изучая названия релизов

Помощник учитывает доступность, качество, размер файла, совместимость видео и аудио, здоровье сидов, язык и подсказки субтитров. Он проверяет выбранный источник и может попробовать другого кандидата, если один не сработает.

Сохраняйте полезность истории просмотра

Реальный прогресс воспроизведения с телевизора сохраняется обратно в Stremio. Частично просмотренные эпизоды можно возобновить позже, а завершённые отмечаются как просмотренные при обычном пороге завершения. Скрейблинг Trakt можно добавить, не делая его обязательным для воспроизведения.

Управляйте остальной частью комнаты

Тот же разговор может открыть Spotify на телевизоре, найти музыку, построить очередь исполнителя, не прерывая текущую песню, управлять воспроизведением или установить громкость телевизора.

Типичный вечер

1. Спросите: «Какие новые эпизоды я могу посмотреть?»

2. Выберите один эпизод или составьте очередь из нескольких шоу.

3. Помощник находит совместимый источник и запускает его на Samsung TV.

4. Прогресс воспроизведения отслеживается, пока вы смотрите.

5. Если вы остановитесь раньше, ваша позиция сохранится. Если вы закончите, состояние просмотра обновится.

6. В режиме марафона или очереди вечер продолжается в выбранном вами порядке.

Что можно спросить

• 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].

Построено вокруг ваших решений

Интеграции независимы:

• Используйте Stremio без Spotify или Trakt.

• Используйте Spotify без подключения Stremio.

• Добавьте Trakt только если хотите скрейблинг.

• Используйте управление телевизором без настройки медиа-аккаунта.

Учётные данные, состояние воспроизведения, очереди и информация о сопряжении остаются на вашем компьютере. HTTP-сервис и локальный аддон Stremio прослушивают только локальную машину.

Текущая поддержка

Samsung остаётся универсальным запасным вариантом и сохраняет свои нативные функции управления питанием, громкостью, запуском приложений, воспроизведением DLNA и телеметрией. Сохранённые приёмники Google Cast, такие как Cellcom Master Boxes, также можно выбирать явно или назначать по умолчанию для одного сетевого отпечатка.

Приоритет целей:

1. Явный target в запросе воспроизведения Stremio.

2. Сохранённая цель для текущего сетевого отпечатка.

3. Samsung.

Сетевые сопоставления и идентификаторы приёмников хранятся в локальном каталоге состояния как media-devices.json; они не фиксируются в проекте.

Spotify и Trakt необязательны. Для воспроизведения Stremio требуется связанная учётная запись Stremio, подходящие аддоны потоков и доступный Samsung TV.

Требования

• Node.js 20 или новее

• Умный телевизор Samsung, доступный из той же локальной сети

• Работающая локальная установка SamsungTVControl для сопряжения, питания и клавиш пульта

• Stremio с установленными нужными аддонами потоков

• Приложение Spotify Developer для функций Spotify

• Приложение Trakt API для необязательного скрейблинга

Установка

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

Локальные учётные данные и состояние создаются в:

%USERPROFILE%\.samsung-spotify-tv\

Прежнее имя каталога сохранено, чтобы существующие установки продолжали работать.

Подключение MCP-клиента

Сервер по умолчанию использует stdio. Укажите MCP-клиенту абсолютный путь к server/index.mjs:

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

Перезапустите MCP-клиент после изменения его конфигурации.

Привязка Stremio

1. Вызовите integration_auth с provider: "stremio" и action: "start".

2. Откройте и одобрите возвращённую ссылку.

3. Вызовите integration_auth с provider: "stremio" и action: "complete".

Подключение Spotify

1. Создайте приложение Spotify Developer.

2. Добавьте http://127.0.0.1:18765/callback как URI перенаправления.

3. Заполните %USERPROFILE%\.samsung-spotify-tv\spotify-credentials.json.

4. Выполните npm run auth.

Подключение Trakt (необязательно)

1. Создайте приложение Trakt API.

2. Заполните %USERPROFILE%\.samsung-spotify-tv\trakt-credentials.json.

3. Вызовите integration_auth с provider: "trakt" и action: "start".

4. Одобрите отображаемый код, затем используйте action: "complete".

Запуск необязательного HTTP-сервиса

npm run mcp:http

Конечная точка MCP: http://127.0.0.1:4512/mcp.

Установка локального аддона Cast to TV

При работающем HTTP-сервисе установите этот URL в настольном Stremio:

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

Это добавляет варианты Cast to TV внутри Stremio. Автоматический выбор использует текущее сетевое сопоставление, а затем переключается на Samsung; именованные цели Samsung и Google Cast также перечислены явно.

Переопределения окружения

Смотрите .env.example для необязательных переопределений пути, имени устройства, сервера Stremio, хоста и порта. Никогда не помещайте реальные учётные данные в .env.example и не фиксируйте заполненный файл окружения.

Версия 0.2.1 предоставляет девять доменно-ориентированных инструментов:

Каждое действие проверяет только параметры, относящиеся к этому действию. Ошибки содержат tool, action, code и message.

Миграция на версию 0.2

Версия 0.2 — это жёсткий переход API инструментов. stremio_queue сохраняет своё имя и контракт. stremio_library сохраняет имя, но теперь требует действие изменения; список библиотеки перенесён в stremio_discover. Другие имена инструментов 0.1 больше не рекламируются и не принимаются.

Поведение воспроизведения

• Явные запросы сезона и эпизода воспроизводятся немедленно.

• Просто названия сериалов предлагают возобновить или начать следующий непросмотренный эпизод.

• Воспроизведение отмечается как просмотренное при 90% завершения.

• Состояние очереди и частичный прогресс сохраняются локально.

• Выключение телевизора завершает сеанс и останавливает автоматическое продвижение.

• Неудачные источники позволяют попробовать следующего кандидата по рейтингу.

Основные компоненты

Проверка

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

Тесты используют временное состояние и блокируют живой телевизор и внешний сетевой доступ.

Безопасность

Это программное обеспечение управляет физическим телевизором и использует аутентифицированные медиа-аккаунты. Держите учётные данные, токены сопряжения, состояние выполнения и журналы вне Git. Не открывайте HTTP MCP или локальный аддон для локальной сети или интернета. См. SECURITY.md.

Лицензия

MIT. См. LICENSE.