Plex MCP 服务器

这是一个基于 Python 的 MCP 服务器，它与 Plex Media Server API 集成，用于搜索电影和管理播放列表。它使用 PlexAPI 库与您的 Plex 服务器进行无缝交互。

设置

前提条件

• Python 3.8 或更高版本
• uv 包管理器
• 具有 API 访问权限的 Plex Media Server

安装

1. 克隆此存储库：

   git clone <repository-url>
   cd plex-mcp
   

2. 使用 uv 安装依赖项：

   uv venv
   source .venv/bin/activate
   uv sync
   

3. 配置 Plex 服务器的环境变量：

   • PLEX_TOKEN：您的 Plex 身份验证令牌
   • PLEX_SERVER_URL：您的 Plex 服务器 URL（例如，http://192.168.1.100:32400）

查找您的 Plex 令牌

您可以通过以下方式找到您的 Plex 令牌：

• 登录到 Plex Web App
• 打开开发者工具
• 在 Console 选项卡中，粘贴并运行：

  window.localStorage.getItem('myPlexAccessToken')
  

与 Claude 一起使用

将以下配置添加到您的 Claude 应用程序：

{
    "mcpServers": {
        "plex": {
            "command": "uv",
            "args": [
                "--directory",
                "FULL_PATH_TO_PROJECT/plex-mcp",
                "run",
                "plex-mcp.py"
            ],
            "env": {
                "PLEX_TOKEN": "YOUR_PLEX_TOKEN",
                "PLEX_SERVER_URL": "YOUR_PLEX_SERVER_URL"
            }
        }
    }
}

可用命令

Plex MCP 服务器公开以下命令：

命令	描述	OpenAPI 参考
search_movies	按标题搜索您媒体库中的电影	/library/sections/{sectionKey}/search
get_movie_details	获取有关特定电影的详细信息	/library/metadata/{ratingKey}
get_movie_genres	获取特定电影的类型	/library/sections/{sectionKey}/genre
list_playlists	列出您的 Plex 服务器上的所有播放列表	/playlists
get_playlist_items	获取特定播放列表中的项目	/playlists/{playlistID}/items
create_playlist	创建一个包含指定电影的新播放列表	/playlists
delete_playlist	从您的 Plex 服务器删除播放列表	/playlists/{playlistID}
add_to_playlist	将电影添加到现有播放列表	/playlists/{playlistID}/items
recent_movies	从您的媒体库获取最近添加的电影	/library/recentlyAdded

测试

该存储库包含一个测试脚本，用于验证连接性和功能：

• simple-direct-plex-test.py - 一个不使用 MCP 服务器的直接 PlexAPI 测试

故障排除

如果您遇到连接问题，请尝试以下步骤：

1. 验证您的环境变量是否已正确设置：

   echo $PLEX_SERVER_URL
   echo $PLEX_TOKEN
   

2. 测试与您的 Plex 服务器的直接连接：

   python simple-direct-plex-test.py