Unified Hi-Fi Control MCP Server

关键词

音频控制JSON-RPC工具执行Claude 集成桥接器

使用说明

  • 项目简介
    • 该仓库中包含一个 MCP 服务器实现（Node.js 版本），利用 Model Context Protocol (MCP) 的 JSON-RPC 机制向 LLM 客户端暴露工具集合。MCP 服务器通过 HTTP bridge 提供对桥接器内置能力的访问，并将结果以 MCP 的标准响应格式返回给客户端。
  • 主要功能点
    • MCP 服务器核心功能
      • 提供工具列表（如 hifi_zones、hifi_now_playing、hifi_control、hifi_search、hifi_play、hifi_status、hifi_hqplayer_status、hifi_hqplayer_profiles、hifi_hqplayer_load_profile、hifi_hqplayer_set_pipeline 等）
      • 接收并执行对桥接端点的工具调用请求，通过桥接实现对区域、当前曲目、控制等操作
    • 与桥接器集成
      • 通过 Bridge 的 HTTP API 与 Unified Hi-Fi Control 桥接器交互，聚合灯笼数据并将结果返回给 MCP 客户端
    • 简易的运行时环境
      • 以 Node.js 运行，默认通过环境变量 BRIDGE_URL 指向桥接器，未设置时默认为 http://localhost:3000
  • 安装步骤
    • 环境准备：确保已安装 Node.js 和 npm/yarn
    • 安装依赖并运行 MCP 服务器
      • 安装依赖并启动：在项目根目录执行 npm install（或 yarn install），然后运行 node mcp/index.js
    • 运行后默认通过标准输入/输出 (stdio) 与 MCP 客户端通信（StdioServerTransport），通过 JSON-RPC 与客户端交互
  • 服务器配置（给 MCP 客户端使用的配置示例，JSON 格式）
    • serverName: unified-hifi-control-mcp
    • command: node
    • args: ["mcp/index.js"]
    • bridgeInterface: 通过桥接器暴露的工具集，客户端需要知道 MCP 服务器地址来发起 JSON-RPC 调用
    • 注释说明
      • serverName 指定 MCP 服务器的标识名称，便于客户端在大规模系统中区分
      • command/args 指定启动 MCP 服务器的命令及参数，与客户端协商建立 JSON-RPC 通道
      • 客户端配置（JSON）示例中应包含服务器名称、命令和参数等，以便正确建立连接
  • 基本使用方法
    • 启动 MCP 服务器后，MCP 客户端（如 Claude/ BoltAI 等）通过 JSON-RPC 调用 MSS 的工具列表与执行工具
    • 客户端应使用服务器提供的工具名称（如 hifi_zones、hifi_now_playing 等）与参数来获取资源、执行操作、查询状态
    • 通过工具执行结果，客户端可获得结构化响应并将结果融入对话或流程中
    • 如需集成到 Claude 等环境，参考 MCP 客户端配置，将服务器地址与端口指向 MCP 服务器暴露的端点

服务器信息

访问项目