zhanting_AI_MCP

展厅智能中控系统 MCP Server | Exhibition Smart Control MCP Server

基于 MCP (Model Context Protocol) 的展厅智能控制接口，允许 AI 模型直接控制展厅内的各类硬件设备，包括电视、灯光、门禁及多媒体播放系统。

A smart control interface for exhibition halls based on MCP, allowing AI models to directly control various hardware devices including TVs, lighting, access control, and multimedia systems.

功能特性 | Features

• 多媒体播控 (Multimedia):
  • 控制 Kodi 播放器点播指定展品视频 (Play specific exhibition videos)
  • 调节音量 (Volume control)
  • 管理闲时自动循环播放/公司宣传片 (Manage idle auto-playback/promo videos)
• 电视电源管理 (TV Power):
  • 支持 6 台电视的独立或批量开关机控制 (Individual or batch control of 6 TVs)
• 智能灯光控制 (Smart Lighting):
  • 一楼大门玄关顶灯/射灯 (Entrance lights/spotlights)
  • 一楼展厅顶灯 (Exhibition hall ceiling lights)
  • 展品桌面灯座总开关 (Desktop display stand switch)
  • 展台桌子灯带 (Stand light strips)
  • 3D 风扇投影 (3D fan projection)
• 门禁系统 (Access Control):
  • 远程开门 (Remote open)
  • 设置常开/常闭/正常模式 (Set modes: Always Open/Closed/Normal)
• 场景模式 (Scenes):
  • 迎宾模式 (Welcome Mode): 一键开启所有迎宾灯光并设置大门常开。
  • 设备重启 (Restart Devices): 自动化执行所有设备的关闭、等待和重启流程。

快速开始 | Quick Start

1. 安装依赖 | Install dependencies

   pip install -r requirements.txt
   

   1. 配置文件 | Configuration
   2. 确保 config.yaml 中配置了正确的 Flask API 地址。

   3. 确保 video_config_prod.yaml 中包含最新的视频列表信息。

   4. 运行服务 | Run Server

      # 启动展厅控制服务
      python mcp_pipe.py calculator.py
      

注：calculator.py 是当前的主逻辑入口文件 (Main entry point)。

可用工具列表 | Available Tools

视频与播放 | Video & Playback

• list_videos: 获取所有可用的视频列表（用于模糊匹配展品名称）。
• kodi_start: 播放指定 ID 的展品视频。
• set_global_volume: 设置全局播放音量。
• control_free_time_playback: 控制闲时自动播放/公司宣传片播放（开启/停止）。
• get_free_time_playback_status: 获取自动播放状态。

电视控制 | TV Control

• turn_on_tv / turn_off_tv: 开关指定编号的电视。
• turn_on_all_tvs / turn_off_all_tvs: 一键开关所有电视。

灯光与设备 | Lighting & Devices

• control_entrance_lights: 玄关顶灯控制。
• control_exhibition_spotlight: 玄关射灯控制。
• control_exhibition_ceiling_light: 展厅顶灯控制。
• control_exhibition_desktop_switch: 桌面灯座总开关。
• control_exhibition_3d_fan: 3D 风扇投影控制。
• control_exhibition_stand_light_strip: 展台灯带控制。

门禁与场景 | Access & Scenes

• open_door: 打开办公楼大门。
• set_door_mode: 设置大门模式（正常/常开/常闭）。
• start_welcome_mode: 启动迎宾模式（开灯、开门）。
• stop_welcome_mode: 关闭迎宾模式（关灯、恢复门禁）。
• restart_all_devices: 重启展厅所有设备。

环境要求 | Requirements

• Python 3.7+
• 依赖库: mcp, requests, pyyaml 等 (见 requirements.txt)
• 需配合后端 Flask API 服务使用 (默认地址: http://192.168.254.242:5050)