VLC MCP 服务器

一个使用 VLC 播放和控制电影的 MCP (模型上下文协议) 服务器。 我将此 MCP 服务器与我的 signal-mcp-client 一起使用，后者位于连接到投影仪的 Raspberry PI 上。 这样，我可以将视频保存到 PI 上的文件夹中，并且可以发送信号消息来播放电影。

Anthropic API 密钥用于使用 claude-haiku 总结视频文件夹中的所有现有视频。

用法

该服务器使用 VLC http 接口来播放和控制电影。 安装 VLC 并使用以下命令启动 http 服务器：

vlc --extraintf=http --http-host=localhost --http-port=8080 --http-password=your_password

您还需要安装 mediainfo 以获取字幕：

注意：我不知道此库是否在 Mac 和 Windows 上可用。 如果您想在那里使用它，您可能需要禁用字幕或找到替代方案。

sudo apt-get install mediainfo

然后安装 uv 并使用 uvx 将服务器添加到 MCP 配置：

{
    "name": "vlc-mcp-server",
    "command": "uvx",
    "args": [
        "vlc-mcp-server"
    ],
    "env": {
        "ANTHROPIC_API_KEY": "your-key",
        "ROOT_VIDEO_FOLDER": "path/to/your/video/folder",
        "VLC_HTTP_HOST": "localhost",
        "VLC_HTTP_PORT": "8080",
        "VLC_HTTP_PASSWORD": "your_password"
    }
}

或者克隆 repo 并将 uv 与目录一起使用：

{
    "name": "vlc-mcp-server",
    "command": "uv",
    "args": [
        "--directory",
        "path/to/root/dir/",
        "run",
        "vlc_mcp_player/main.py"
    ],
    "env": {
        "the same as above"
    }
}

开发

测试

克隆 repo 并使用 mcp-client-for-testing 来测试服务器的工具。

uvx mcp-client-for-testing \
    --config '
    [
        "the json config from above"
    ]
    ' \
    --tool_call '{"name": "show_video", "arguments": {"video_title": "David Lynch - Dune", "subtitle_language_code": "en"}}'

格式化和 Linting

代码使用 ruff 进行格式化和 linting：

uv run ruff format
uv run ruff check --fix

使用 uv 构建

使用 uv 构建包：

uv build

发布新版本

要将软件包的新版本发布到 PyPI：

1. 创建并推送遵循语义版本控制的新 Git 标签：

   git tag v0.2.0
   git push origin v0.2.0
   

当推送新标签时，GitHub Actions 工作流程将自动构建并将软件包发布到 PyPI。 版本号将直接从 Git 标签派生。

许可证

该项目根据 MIT 许可证获得许可。 有关详细信息，请参见 LICENSE 文件。