arr-assistant-mcp

🚀 arr-assistant-mcp

arr-assistant-mcp是一个MCP服务器，可通过自然语言查询将电影和电视剧添加到Radarr/Sonarr中，为影视资源管理提供便捷的操作方式。

🚀 快速开始

环境要求

需要Python 3.12及以上版本和 uv。

安装步骤

git clone <repo>
cd arr-assistant-mcp
uv sync

📦 安装指南

配置文件设置

将以下内容添加到 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "arr-assistant": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/arr-assistant-mcp/",
        "run",
        "src/arr_assistant_mcp/main.py"
      ],
      "env": {
        "RADARR_URL": "http://your-ip:7878",
        "RADARR_API_KEY": "your-radarr-api-key",
        "SONARR_URL": "http://your-ip:8989",
        "SONARR_API_KEY": "your-sonarr-api-key"
      }
    }
  }
}

API密钥获取

• Radarr/Sonarr：进入设置（Settings）→ 常规（General）→ API密钥（API Key）即可获取。

📚 详细文档

工具函数说明

• test_config() - 测试配置和连接性。
• search_movies(title) - 按标题搜索电影。
• add_movie_by_id(tmdb_id, root_folder=None) - 将电影添加到Radarr。
• search_and_add_show(description) - 搜索电视剧并添加到Sonarr。
• add_show_by_tvdb_id(tvdb_id, title, root_folder=None) - 将电视剧添加到Sonarr。
• get_server_status() - 检查Radarr/Sonarr的状态。

💻 使用示例

基础用法

search_movies("The Matrix")
add_movie_by_id(603)

# 指定自定义根文件夹
add_show_by_tvdb_id(123456, "Attack on Titan", "/storage/anime")

根文件夹会从你的Radarr/Sonarr配置中自动检测，但也可以针对每个请求进行覆盖。