Plex MCP Server

基本能力

产品定位

Plex MCP Server 是一个为 Plex Media Server 提供标准化 JSON 接口的中间层，旨在简化自动化、脚本编写和与其他工具的集成。

核心功能

• 标准化的 JSON 响应，兼容自动化工具和 AI 系统
• 多种传输方法（stdio 和 SSE）
• 丰富的命令集，包括库管理、媒体管理、播放列表管理、用户管理等
• 一致的错误处理格式
• 易于与自动化平台（如 n8n）和自定义脚本集成

适用场景

• 自动化媒体库管理
• 脚本化媒体内容操作
• 与其他工具（如 Claude Desktop 或 Cursor）集成
• Web 应用程序通过 SSE 连接

工具列表

• Library Module: 管理库，包括列出库、获取统计信息、刷新库等
• Media Module: 搜索媒体、获取媒体信息、编辑元数据等
• Playlist Module: 管理播放列表，包括创建、删除、编辑等
• Collection Module: 管理集合，包括创建、添加项、删除项等
• User Module: 搜索用户、获取用户信息等
• Sessions Module: 获取活动会话和播放历史
• Server Module: 获取服务器日志、信息、带宽统计等
• Client Module: 列出客户端、控制播放等（功能有限）

常见问题解答

• 未在 README 中提供具体常见问题解答。

使用教程

使用依赖

• Python 3.8+
• Plex Media Server 及有效的认证令牌
• 访问 Plex 服务器（本地或远程）

安装教程

1. 克隆仓库
2. 安装依赖： pip install -r requirements.txt
3. 创建 .env 文件： cp .env.example .env
4. 在 .env 文件中添加 Plex 服务器 URL 和令牌： PLEX_URL=http://your-plex-server:32400 PLEX_TOKEN=your-plex-token

调试方式

• 使用 watcher.py 脚本监控更改并自动重启服务器。

运行方式

stdio 传输模式

python3 -m plex_mcp

或

python3 plex_mcp_server.py --transport stdio

SSE 传输模式

python3 plex_mcp_server.py --transport sse --host 0.0.0.0 --port 3001

许可证

None