AI导哈

Plex媒体服务器接口

Plex MCP Server是一个为Plex Media Server提供标准化JSON接口的模型-控制器-协议服务器，支持自动化、脚本编写和与其他工具的集成。

  • by EuleMitKeule
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 EuleMitKeule/plex-mcp-server

使用说明

Plex MCP服务器

注意： 此存储库在很大程度上基于 vladimir-tutin/plex-mcp服务器设计、结构和功能的很大一部分来自原始项目。

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

概述

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

  • 标准化JSON响应 与自动化工具、人工智能系统和其他集成兼容
  • 多种运输方式 （stdio和SSE）提供灵活的集成选项
  • 丰富的命令集 用于管理库、收藏、播放列表、媒体、用户等
  • 错误处理 具有一致的响应格式
  • 易于集成 使用自动化平台（如n8n）和自定义脚本

安装

使用提供的 docker-compose.yml 文件，以便轻松部署服务器。

环境变量

您可以使用环境变量配置服务器。以下变量可用：

变量 描述
PLEX_URL Plex媒体服务器的URL（例如。， http://localhost:32400)
PLEX_TOKEN 您的Plex身份验证令牌
PLEX_USERNAME 用于请求的Plex用户的用户名（可选）
PERMISSIONS 授予权限(read, write 或 delete，较高权限包括以前的权限）
HOST 将服务器绑定到的主机（默认值： 0.0.0.0)
PORT 运行服务器的端口（默认值： 8000)
TRANSPORT 使用的运输方式(stdio 或 sse，默认值： sse)
DEBUG 启用调试日志记录（默认值： false)

响应格式

所有命令都返回标准化的JSON响应，以最大限度地兼容各种工具、自动化平台和AI系统。这种一致的结构使得以编程方式处理响应变得容易。

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

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

对于错误，响应格式为：

{
  "error": "Error message describing what went wrong"
}

对于多个匹配（按标题搜索时），结果将作为具有标识信息的对象数组返回：

[
  {
    "title": "Item Title",
    "id": 12345,
    "type": "movie",
    "year": 2023
  },
  {
    "title": "Another Item",
    "id": 67890,
    "type": "show",
    "year": 2022
  }
]

相关 MCP