Plex MCP Server

🚀 Plex MCP 服務器

Plex MCP 服務器是一個強大的模型 - 控制器 - 協議服務器，可與 Plex 媒體服務器進行交互。它提供標準化的 JSON 接口，方便實現自動化、腳本編寫以及與其他工具的集成。

🚀 快速開始

Plex MCP Server 在 plex 媒體服務器 API 之上創建了一個統一的 API 層，具備以下優勢：

• 標準化 JSON 響應：確保與自動化工具、人工智能系統和其他集成的兼容性。
• 多種傳輸方式：支持標準輸入輸出和 SSE，實現靈活的集成選項。
• 豐富的命令集：可用於管理庫、集合、播放列表、媒體、用戶等。
• 一致的錯誤處理格式。
• 易於集成：能輕鬆與自動化平臺（如 n8n）和自定義腳本集成。

✨ 主要特性

• 標準化響應：提供標準化的 JSON 響應，方便與各類工具集成。
• 多傳輸方式：支持標準輸入輸出和 SSE 兩種傳輸方式，滿足不同場景需求。
• 豐富命令集：涵蓋庫、媒體、播放列表等多個模塊的管理命令。
• 統一錯誤處理：採用一致的錯誤處理格式，便於調試和維護。
• 集成便捷：易於與自動化平臺和自定義腳本集成。

📦 安裝指南

安裝需求

• 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 腳本，該腳本會監視更改並自動重啟服務器。

📄 許可證

[在此處包含您的許可信息]