Sonos TypeScript MCP 服务器

您的全面 Sonos 控制伴侣，由模型上下文协议（MCP）提供支持。此智能服务器通过本地网络使用 UPnP/SOAP 协议无缝访问 Sonos 音频设备。无论是控制播放、管理区域、浏览音乐库还是设置闹钟，此 MCP 服务器都能直接向您的 AI 助手提供完整的设备控制，实现智能家居自动化和更好的音频体验。

特别设计用于编码代理和 AI 驱动的家庭音频自动化工作流。 此服务器使 AI 助手能够构建智能多房间音频体验、音乐库管理、区域分组、队列管理以及与智能家居平台的集成。

数据来源于实时 UPnP/SOAP 通信与 Sonos 设备，以确保准确性和完整性。

📊 特性状态：第 4 阶段完成！实现了使用 UPnP GENA 协议的实时事件订阅，包括播放、音量、队列和拓扑变化。详情见 第 4 阶段完成。

📚 文档

• 全面工具描述 - 为编码代理提供的详细指南，包括用例、工作流程和最佳实践，涵盖 50 多种工具。
• API 参考 - 技术 API 文档。
• 示例脚本 - 自动化脚本示例和用例。

开始使用

Sonos TypeScript MCP 服务器可以与任何支持标准 I/O（stdio）作为传输介质的 MCP 客户端一起工作。以下是部分流行工具的具体配置说明：

基础配置

Claude Desktop

要配置 Claude Desktop 使用 Sonos MCP 服务器，请编辑 claude_desktop_config.json 文件。您可以通过 Claude > 设置菜单打开或创建此文件。选择开发者标签页，然后点击编辑配置。

{
  "mcpServers": {
    "sonos-ts-mcp": {
      "command": "npx",
      "args": ["-y", "sonos-ts-mcp@latest"]
    }
  }
}

Cline

要配置 Cline 使用 Sonos MCP 服务器，请编辑 cline_mcp_settings.json 文件。您可以通过点击 Cline 面板顶部的 MCP 服务器图标，然后点击配置 MCP 服务器按钮来打开或创建此文件。

{
  "mcpServers": {
    "sonos-ts-mcp": {
      "command": "npx",
      "args": ["-y", "sonos-ts-mcp@latest"],
      "disabled": false
    }
  }
}

Cursor

要配置 Cursor 使用 Sonos MCP 服务器，请编辑 .cursor/mcp.json 文件（仅配置特定项目）或 ~/.cursor/mcp.json 文件（在所有项目中可用）。

{
  "mcpServers": {
    "sonos-ts-mcp": {
      "command": "npx",
      "args": ["-y", "sonos-ts-mcp@latest"]
    }
  }
}

Visual Studio Code Copilot

要配置单个项目，请编辑工作区中的 .vscode/mcp.json 文件：

{
  "servers": {
    "sonos-ts-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "sonos-ts-mcp@latest"]
    }
  }
}

要使服务器在每个打开的项目中都可用，请编辑用户设置：

{
  "mcp": {
    "servers": {
      "sonos-ts-mcp": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "s