Moviepilot MCP

🚀 MoviePilot - MCP

MoviePilot - MCP 是專門為電影愛好者打造的 MCP（MCP 可能指多用途控制面板或其他相關技術術語）服務，它基於 MoviePilot 的 API 構建。該服務提供了一個統一的控制檯，能幫助用戶管理媒體庫、搜索下載資源，還能監控下載任務的狀態。

🚀 快速開始

MoviePilot - MCP 是基於 MoviePilot API 構建的服務，為用戶提供了便捷的媒體管理和下載功能。下面為你介紹如何開始使用該服務。

先決條件

• 操作系統：Python 3.12+ 環境
• 工具：uv 包管理器
• 基礎設施：一個正在運行且可訪問的 MoviePilot 服務實例

配置步驟

1. 克隆倉庫：

git clone https://github.com/Pollo3470/MoviePilot - MCP
cd MoviePilot - MCP

2. 創建配置文件：
   • 複製 .env.example 文件並重命名為 .env
   • 填寫必要的配置信息，例如：

# .env 示例
MOVIEPILOT_BASE_URL=http://your - moviepilot - ip:3000  # 你的 MoviePilot 地址

# 配置認證方式
MOVIEPILOT_USERNAME=your_moviepilot_username  # 你的 MoviePilot 用戶名（用於密碼認證）
MOVIEPILOT_PASSWORD=your_moviepilot_password  # 你的 MoviePilot 密碼（用於密碼認證）

3. 創建開發環境：

uv sync

✨ 主要特性

• 統一控制檯：在一個地方管理和監控所有媒體相關的操作。
• 智能搜索：通過精確和模糊搜索功能快速找到所需的電影或電視劇。
• 可擴展性：設計靈活，未來計劃提供 SSE 部署方式。
• 安全性：內置安全措施，確保環境和賬號的安全。

📦 安裝指南

先決條件

• 操作系統：Python 3.12+ 環境
• 工具：uv 包管理器
• 基礎設施：一個正在運行且可訪問的 MoviePilot 服務實例

配置步驟

1. 克隆倉庫：

git clone https://github.com/Pollo3470/MoviePilot - MCP
cd MoviePilot - MCP

2. 創建配置文件：
   • 複製 .env.example 文件並重命名為 .env
   • 填寫必要的配置信息，例如：

# .env 示例
MOVIEPILOT_BASE_URL=http://your - moviepilot - ip:3000  # 你的 MoviePilot 地址

# 配置認證方式
MOVIEPILOT_USERNAME=your_moviepilot_username  # 你的 MoviePilot 用戶名（用於密碼認證）
MOVIEPILOT_PASSWORD=your_moviepilot_password  # 你的 MoviePilot 密碼（用於密碼認證）

3. 創建開發環境：

uv sync

💻 使用示例

基礎用法

以下是克隆倉庫和創建開發環境的基礎操作示例：

# 克隆倉庫
git clone https://github.com/Pollo3470/MoviePilot - MCP
cd MoviePilot - MCP

# 創建開發環境
uv sync

📚 詳細文檔

功能模塊

1. 媒體庫管理

• 添加媒體：通過 API 將新內容添加到媒體庫中。
• 刪除媒體：移除不再需要的內容。
• 搜索媒體：按標題、年份或類別查找特定的電影或電視劇。

2. 下載任務控制

• 啟動下載：開始新的下載任務。
• 暫停/恢復：臨時停止或重新啟動正在下載的任務。
• 刪除任務：取消未完成的下載任務。

3. 資源管理

• 資源搜索：根據 TMDB ID 或豆瓣 ID 查找可下載的種子。
• 模糊搜索：通過關鍵詞查找資源。
• 歷史記錄：查看過去的下載記錄。

開發狀態

當前，項目處於功能逐步接入階段。未來計劃包括提供 SSE 部署方式，以增強服務的擴展性和性能。

🔧 技術細節

當前，項目處於功能逐步接入階段。未來計劃包括提供 SSE 部署方式，以增強服務的擴展性和性能。

📄 許可證

該項目遵循 [LICENSE] 協議，具體內容請參見項目的 LICENSE 文件。

📌 安全提示

⚠️ 重要提示

• 環境安全：確保存儲 MoviePilot 賬號信息的環境安全。
• 賬號安全：建議創建專用賬號用於此 MCP 服務器，避免使用管理員賬號。

🤝 貢獻

歡迎社區貢獻！如發現 bug 或有功能建議，請通過倉庫 Issues 提交。您的貢獻將幫助項目不斷改進。

🙏 致謝

感謝 MoviePilot 項目的技術支持，使得本 MCP 服務的開發成為可能。