Plex MCP 服务器

一个强大的模型-控制器-协议服务器，用于与 Plex 媒体服务器交互，提供标准化的 JSON 接口以实现自动化、脚本编写和其他工具的集成。

概述

Plex MCP Server 在plex媒体服务器API之上创建了一个统一的API层，提供：

• 标准化JSON响应，确保与自动化工具、人工智能系统和其他集成的兼容性
• 多种传输方式（标准输入输出和SSE）以实现灵活的集成选项
• 丰富的命令集，用于管理库、集合、播放列表、媒体、用户等
• 一致的错误处理格式
• 易于与自动化平台（如n8n）和自定义脚本集成

需求

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

安装

1. 克隆此仓库
2. 安装所需的依赖项：

   pip install -r requirements.txt
   

3. 根据.env.example创建一个.env文件：

   cp .env.example .env
   

4. 将您的plex服务器URL和令牌添加到.env文件中：

   PLEX_URL=http://your-plex-server:32400
   PLEX_TOKEN=your-plex-token
   

使用

标准输入输出（stdio）模式

启动服务器的命令如下：

python server.py

SSE 模式

启动服务器的命令如下：

python sse_server.py

命令模块

库模块

• add_library：添加新的库
• remove_library：删除现有库
• list_libraries：列出所有库
• update_library：更新特定库的配置

媒体模块

• search_media：按标题、类型或年份搜索媒体
• get_media_info：获取特定媒体的详细信息
• add_media：添加新的媒体到库中
• remove_media：从库中删除特定媒体

播放列表模块

• create_playlist：创建新的播放列表
• delete_playlist：删除现有的播放列表
• add_to_playlist：将媒体添加到播放列表中
• remove_from_playlist：从播放列表中移除媒体

响应格式

对于成功操作，响应通常包括：

{
  "success_field": true,
  "relevant_data": "value",
  "additional_info": {}
}

对于错误，响应格式为：

{
  "error": "错误消息，描述发生的问题"
}

对于多个匹配项（按标题搜索时），结果以包含识别信息的对象数组的形式返回：

[
  {
    "title": "项目标题",
    "id": 12345,
    "type": "电影",
    "year": 2023
  },
  {
    "title": "另一个项目",
    "id": 67890,
    "type": "剧集",
    "year": 2022
  }
]

调试

为了开发和调试，您可以使用随附的watcher.py脚本，该脚本监视更改并自动重启服务器。

许可证

[在此处包含您的许可信息]