ZoneFoundry for Sonos

Sonos MCP server: control your Sonos speakers from any MCP client.

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

  • Ask Zonefoundry: Sends a request in natural language to the user's ZoneFoundry assistant, which carries it out on the user's Sonos system and returns a reply. It handles playing songs, artists, albums
  • List Rooms: List this user's Sonos rooms and current groups (cloud topology).
  • Now Playing: Current playback state (track/artist/state/volume) for a room.

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

Sonos MCP server: control your Sonos speakers from any MCP client. Play songs, artists and playlists, set volume, group rooms, move music to another room, switch to TV, spoken announcements and reminders. 27 tools, English and Chinese. Works through the official Sonos cloud, so there is no home bridge to install; sign in with OAuth. Requires the free ZoneFoundry iOS app signed in to your Sonos account.

Как подключить

Как подключить ZoneFoundry for Sonos к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://zonefoundry--kisssam6886.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить ZoneFoundry for Sonos к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://zonefoundry--kisssam6886.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить ZoneFoundry for Sonos к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://zonefoundry--kisssam6886.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (27)

Технические названия из tools/list. Нужны только разработчикам.

ask_zonefoundrySends a request in natural language to the user's ZoneFoundry assistant, which carries it out on the user's Sonos system and returns a reply. It handles playing songs, artists, albums and playlists, news and radio, spoken announcements, scenes and multi-step requests, across Apple Music, Spotify, QQ Music and NetEase Cloud Music, and understands English and Chinese (Mandarin and Cantonese). An artist name plays about 10 of that artist's songs. Without the ZoneFoundry bridge, tracks play directly on the speaker and are added to the Sonos queue the next time the ZoneFoundry app is opened. Examples: 'play some jazz in the kitchen', 'play the morning news in the bedroom', '喺客厅播周杰伦'.
list_roomsList this user's Sonos rooms and current groups (cloud topology).
now_playingCurrent playback state (track/artist/state/volume) for a room.
toggle_play_pauseToggle play/pause in a room's group.
next_trackSkip to next track in a room's group.
previous_trackSkip to previous track in a room's group.
set_volumeSet a room's volume (0-70; values above 70 are clamped for safety).
adjust_volumeRaises or lowers a room's volume by a relative amount (-30 to 30); the current level does not need to be known.
set_muteMutes or unmutes a single room. Muting keeps playback running.
set_play_modeTurns shuffle and/or repeat on or off for a room's group. repeat: 'off' | 'all' (repeat the queue) | 'one' (repeat the current track). Only the settings that are passed are changed.
set_home_theaterChanges soundbar settings: night mode (quieter loud scenes, clearer quiet ones) and speech enhancement (clearer dialogue). Applies to Sonos soundbars; if the named room has no soundbar, the home's soundbar is used. Only the settings that are passed are changed.
move_musicMoves what's playing from one room to another: the music continues in `to_room` and stops in `from_room` (other rooms grouped with `from_room` keep playing).
switch_sourceSwitch a room between music, TV audio (soundbar HDMI/optical) and line-in. All three go through Sonos' cloud, so the user doesn't need to be home or have the app open; TV picks a soundbar with a TV input, line-in picks a speaker with a line-in port. Only if the cloud can't switch to TV does it fall back to the ZoneFoundry app on the home Wi-Fi.
seekJump to a position in the current track, in seconds from the start (e.g. 90 = 1:30). Only works while something is playing.
group_roomsGroup one or more rooms onto `room` so they all play the same thing. `room` stays the one that keeps playing; the others join it.
ungroup_roomTake a room out of whatever group it is in, so it plays on its own again.
play_musicSearches for a song or artist and starts playback in a room through the Sonos cloud. A query of 'title artist' plays one song; an artist name alone plays a batch of that artist's songs, with duplicate versions of the same title removed. Without the ZoneFoundry bridge, tracks play directly on the speaker and are added to the Sonos queue the next time the ZoneFoundry app is opened.
search_musicSearches for songs without playing them and returns candidate tracks (name, artist, album, duration).
announceSpeaks a short text message aloud on a room's Sonos speaker using text-to-speech. Music pauses during the message and then resumes. Up to 300 characters, at least 8 seconds apart; one message can carry several items. language: zh-CN / zh-HK / en-US; when omitted, the home's language preference is used.
set_reminderSchedules a one-time spoken reminder: at the given time the room's Sonos speaker reads the text aloud (text-to-speech). Takes either `at` (the home's local time, 24-hour HH:MM) or `in_minutes`. Examples: {text:'Time to get up',room:'Bedroom',at:'07:30'} / {text:'焗炉好了',room:'客厅',in_minutes:20}. This is ZoneFoundry's own scheduler, separate from native Sonos alarms.
list_remindersList pending spoken reminders created via this MCP connection.
cancel_reminderCancels a pending reminder by its reminderId.
play_historyLists recent requests this home made to ZoneFoundry, newest first: the user's own words (e.g. 'play Norah Jones', '播周杰伦'), with time, channel and whether each succeeded. Covers requests made through the ZoneFoundry assistant, the app's voice and command features, messaging bots and this connection; music started by browsing in the app or in the Sonos app is not recorded. Entries contain the request text only, with no structured track or artist fields.
taste_profileReturns this home's learned listening profile (usual artists, genres, rooms, times of day and language habits) plus request statistics (most repeated requests, busiest hours, channels). Same coverage as the play history. The profile is regenerated daily and may be empty for a new user; statistics are computed live.
list_favoritesLists the home's Sonos favorites (title, artist, position, service) in the order Sonos stores them. Works without the ZoneFoundry bridge. Sonos caps favorites at about 70 items; `total` is the real count.
list_playlistsLists the home's Sonos playlists (id, title, track count). Works without the ZoneFoundry bridge. An error response means the list could not be read, not that there are no playlists.
undo_lastReverts the most recent volume or grouping change made in this home within the last 10 minutes, restoring every room's prior volume and group layout. Each change can be undone once; repeated calls step back through earlier changes. Playback, favorites, alarms and other settings are not affected.