艾媒体守护者🎬
该项目提供了一个微命令协议(MCP)服务器,用于控制VLC媒体播放器实例。 🕹️ 它允许您通过简单的基于文本的界面与VLC交互,使其适合自动化和与其他系统的集成。
特性✨
- 远程控制: 控制VLC播放(播放▶️, 暂停⏸️, 停止⏹️, 远程搜索)。
- 音量控制: 调节音量🔊 以及静音/取消静音🔇 VLC。
- 状态监控: 检索VLC播放器的当前状态(播放、暂停、标题等)。 ℹ️
- 视频设置: 调整视频亮度🔆, 宽高比和作物。
- 音频设置: 调整播放速率⏩ 并选择音频设备。
- 快照: 拍摄当前视频帧的快照。 📸
- MCP接口: 使用微命令协议(MCP)进行通信,便于集成。 🤝
先决条件⚙️
- VLC媒体播放器: VLC必须安装在您的系统上。 💻
- python 需要Python 3.6或更高版本。 🐍
- Python包: 需要以下Python包:
- mcp - requests - urllib3 - socket
安装🚀
- 克隆存储库:
git clone [repository URL]
cd [repository directory]- 安装依赖项:
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启动的时间(秒)。
用法💡
- 启动MCP服务器:
python src/mcp_server.py这将启动MCP服务器,该服务器监听标准输入(stdio)上的命令。
- 与服务器交互:
您可以使用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许可证\]
