arr-assistant-mcp

用于通过自然语言查询向Radarr/Sonarr添加电影和电视节目的MCP服务器。

安装

需要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: 设置 → 通用 → API密钥

工具

• 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配置中自动检测，但可以在每次请求时进行覆盖。