AI导哈

VLC媒体控制协议

一个通过微命令协议(MCP)控制VLC媒体播放器的服务，支持远程控制、状态监控和视频/音频设置。

  • by codeesasi
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 codeesasi/Ai-Media-Guardian

使用说明

艾媒体守护者🎬

该项目提供了一个微命令协议（MCP）服务器，用于控制VLC媒体播放器实例。 🕹️ 它允许您通过简单的基于文本的界面与VLC交互，使其适合自动化和与其他系统的集成。

特性✨

  • 远程控制： 控制VLC播放（播放▶️, 暂停⏸️, 停止⏹️, 远程搜索）。
  • 音量控制： 调节音量🔊 以及静音/取消静音🔇 VLC。
  • 状态监控： 检索VLC播放器的当前状态（播放、暂停、标题等）。 ℹ️
  • 视频设置： 调整视频亮度🔆, 宽高比和作物。
  • 音频设置： 调整播放速率⏩ 并选择音频设备。
  • 快照： 拍摄当前视频帧的快照。 📸
  • MCP接口： 使用微命令协议（MCP）进行通信，便于集成。 🤝

先决条件⚙️

  • VLC媒体播放器： VLC必须安装在您的系统上。 💻
  • python 需要Python 3.6或更高版本。 🐍
  • Python包： 需要以下Python包：
    • mcp
    • requests
    • urllib3
    • socket

安装🚀

  1. 克隆存储库：

    git clone [repository URL]
cd [repository directory]

  2. 安装依赖项：

    pip install -r requirements.txt

    （创建一个 requirements.txt 文件包含 mcp, requests, urllib3)

配置🛠️

编辑 settings.py 文件以配置以下设置：

  • VLC_PATH：VLC可执行文件的路径。
  • VLC_HOST：运行VLC HTTP接口的主机名或IP地址。默认为 http://localhost.
  • VLC_PORT：VLC HTTP接口的端口号。默认为 8080.
  • VLC_PASSWORD：用于访问VLC HTTP接口的密码。 🔑
  • VLC_STARTUP_WAIT：发送命令前等待VLC启动的时间（秒）。

用法💡

  1. 启动MCP服务器：

    python src/mcp_server.py

    这将启动MCP服务器，该服务器监听标准输入（stdio）上的命令。

  2. 与服务器交互：

    您可以使用MCP客户端向服务器发送命令。例如：

    tool launch_vlc
tool load_video /path/to/your/video.mp4
tool play
tool pause
tool status
tool shutdown_vlc

项目结构📂

  • src/mcp_server.py：主MCP服务器脚本。
  • src/vlc_controller.py：包含低级VLC控制逻辑。
  • settings.py：VLC设置的配置文件。
  • requirements.txt：列出Python包依赖项。
  • README.md：这个文件。 📝

贡献🤝

欢迎投稿！请随时提交拉取请求或未决问题。

许可证📜

[此处为许可证信息，例如MIT许可证]

相关 MCP