用于Overseer的MCP服务器
MCP服务器与Overserr API交互，用于电影和电视节目请求管理。
组件
工具
服务器实现了多种与Overseer交互的工具：
- overseer_status：获取Overseer服务器的状态
- overseer_movie_requests：获取满足过滤器参数的所有电影请求的列表
- overseer_tv_requests：获取满足过滤器参数的所有电视节目请求的列表
示例提示
最好先指导克劳德使用Overseer。然后，它将在适当的时候调用该工具。
尝试以下提示：
- 获取我们的Overseer服务器的状态
- 显示当前待处理的所有电影请求
- 列出上个月现在可用的所有电视节目请求
- 哪些电影已被要求但尚未上映？
- 我们图书馆最近有哪些电视节目？
配置
监管人API密钥和URL
有两种方法可以使用Overserr API凭据配置环境：
- 添加到服务器配置（首选）
{
"overseerr-mcp": {
"command": "uvx",
"args": [
"overseerr-mcp"
],
"env": {
"OVERSEERR_API_KEY": "",
"OVERSEERR_URL": ""
}
}
}- 创建一个
.env工作目录中的文件，其中包含以下必需变量：
OVERSEERR_API_KEY=your_api_key_here
OVERSEERR_URL=your_overseerr_url_here注意：您可以在“API密钥”下的Overserr设置中找到API密钥。
快速启动
安装
监管人API密钥
您需要一个正在运行的Overserr实例和一个API密钥：
- 导航到您的Overseer安装
- 转到“设置”→ 将军
- 查找“API密钥”部分
- 如果您还没有新的API密钥，请生成一个新的
克劳德桌面
在MacOS上： ~/Library/Application\ Support/Claude/claude_desktop_config.json
在Windows上： %APPDATA%/Claude/claude_desktop_config.json
Development/Unpublished Servers Configuration
{
"mcpServers": {
"overseerr-mcp": {
"command": "uv",
"args": [
"--directory",
"/overseerr-mcp",
"run",
"overseerr-mcp"
],
"env": {
"OVERSEERR_API_KEY": "",
"OVERSEERR_URL": ""
}
}
}
}注意：此MCP服务器尚未发布。目前，只有开发配置可用。
发展
建筑
准备分发包裹：
- 同步依赖关系并更新锁文件：
uv sync调试
由于MCP服务器在stdio上运行，调试可能具有挑战性。为了达到最佳调试效果 经验，我们强烈建议使用 MCP检查员.
您可以通过以下方式启动MCP检查器 使用此命令：
npx @modelcontextprotocol/inspector uv --directory /path/to/overseerr-mcp run overseerr-mcp启动后，检查器将显示一个URL，您可以在浏览器中访问该URL以开始调试。
您还可以使用以下命令查看服务器日志：
tail -n 20 -f ~/Library/Logs/Claude/mcp-server-overseerr-mcp.log```