# Spotify Soundtrack MCP

MCP-сервер Spotify Soundtrack MCP для Claude Code связывает Spotify с TMDB и помогает собирать плейлисты по фильмам. Он также управляет плейлистами и показывает статистику музыкальных предпочтений.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 у репозитория
- Автор: Chiru144
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Chiru144/Spotify-MCP-Web-And-MCP-Server
- Обновлён: 2026-11-09
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/spotify-soundtrack-mcp

## Что делает

Сервер ищет фильмы, актёров и съёмочную группу в TMDB, затем подбирает музыку и создаёт плейлисты Spotify по фильмографии. Он также умеет курировать плейлисты, анализировать музыкальные предпочтения и управлять воспроизведением через Spotify Connect.

Для входа в Spotify нужен `SPOTIPY_CLIENT_ID`: авторизация проходит через браузер по PKCE, без client secret. Для TMDB задаётся `TMDB_API_KEY` или `TMDB_READ_ACCESS_TOKEN`. В режиме разработки Spotify часть функций недоступна: например, данные об аудиохарактеристиках не возвращаются, а профили других пользователей закрыты. Генераторы сначала показывают предварительный вариант и создают плейлист только с `create=True`.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add --env SPOTIPY_CLIENT_ID=<SPOTIPY_CLIENT_ID> --env SPOTIPY_REDIRECT_URI=<SPOTIPY_REDIRECT_URI> --env TMDB_API_KEY=<TMDB_API_KEY> --env TMDB_READ_ACCESS_TOKEN=<TMDB_READ_ACCESS_TOKEN> --env SPOTIFY_TOOLSETS=<SPOTIFY_TOOLSETS> --transport stdio spotify-soundtrack-mcp -- uvx spotify-soundtrack-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from spotify-soundtrack-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add spotify-soundtrack-mcp --env SPOTIPY_CLIENT_ID=<SPOTIPY_CLIENT_ID> --env SPOTIPY_REDIRECT_URI=<SPOTIPY_REDIRECT_URI> --env TMDB_API_KEY=<TMDB_API_KEY> --env TMDB_READ_ACCESS_TOKEN=<TMDB_READ_ACCESS_TOKEN> --env SPOTIFY_TOOLSETS=<SPOTIFY_TOOLSETS> -- uvx spotify-soundtrack-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from spotify-soundtrack-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "spotify-soundtrack-mcp": {
            "command": "uvx",
            "args": [
                "spotify-soundtrack-mcp"
            ],
            "env": {
                "SPOTIPY_CLIENT_ID": "<SPOTIPY_CLIENT_ID>",
                "SPOTIPY_REDIRECT_URI": "<SPOTIPY_REDIRECT_URI>",
                "TMDB_API_KEY": "<TMDB_API_KEY>",
                "TMDB_READ_ACCESS_TOKEN": "<TMDB_READ_ACCESS_TOKEN>",
                "SPOTIFY_TOOLSETS": "<SPOTIFY_TOOLSETS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from spotify-soundtrack-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "spotify-soundtrack-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "spotify-soundtrack-mcp"
            ],
            "env": {
                "SPOTIPY_CLIENT_ID": "<SPOTIPY_CLIENT_ID>",
                "SPOTIPY_REDIRECT_URI": "<SPOTIPY_REDIRECT_URI>",
                "TMDB_API_KEY": "<TMDB_API_KEY>",
                "TMDB_READ_ACCESS_TOKEN": "<TMDB_READ_ACCESS_TOKEN>",
                "SPOTIFY_TOOLSETS": "<SPOTIFY_TOOLSETS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from spotify-soundtrack-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e SPOTIPY_CLIENT_ID=<SPOTIPY_CLIENT_ID> -e SPOTIPY_REDIRECT_URI=<SPOTIPY_REDIRECT_URI> -e TMDB_API_KEY=<TMDB_API_KEY> -e TMDB_READ_ACCESS_TOKEN=<TMDB_READ_ACCESS_TOKEN> -e SPOTIFY_TOOLSETS=<SPOTIFY_TOOLSETS> spotify-soundtrack-mcp uvx spotify-soundtrack-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from spotify-soundtrack-mcp <команда>

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

## Примеры запросов агенту
- Собери плейлист Spotify по фильмографии актёра из индийского кино.
- Найди саундтрек к фильму через TMDB и создай плейлист.
- Покажи статистику моей музыкальной библиотеки Spotify.

## Похожие
- [soundtrack](https://affpapa.org/nevibecode/skills/soundtrack.md) — скилл · 1100 установок
- [Spotify Pitch Generator by Velveteen](https://affpapa.org/nevibecode/mcp/spotify-pitch-generator-by-velveteen.md) — MCP-сервер · 575 установок
- [connector-spotify](https://affpapa.org/nevibecode/skills/connector-spotify.md) — скилл · 10700 установок
- [spotify-player](https://affpapa.org/nevibecode/skills/spotify-player.md) — скилл · 5400 установок
- [Spotify Automation](https://affpapa.org/nevibecode/skills/spotify-automation.md) — скилл · 4800 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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