Trakt MCP服务器
作为中介的MCP（模型上下文协议）服务器，使LLM模型能够与Trakt.tv API交互。
Docker镜像： 邓森/特拉克电视台
快速开始
1.安装
克隆存储库并安装依赖项：
# Cloning the repository
git clone https://github.com/Dhenyson/trakt-tv-mcp.git
cd trakt-mcp
# Create a virtual environment
python3 -m venv .venv # Or specific the version: python3.10 -m venv .venv
# Activate the virtual environment
source .venv/bin/activate # On Windows: .venv\Scripts\activate
# Install dependencies
pip install -e .2.运行服务器
使用FastMCP启动服务器：
python3 src/server.py服务器将于启动 http://127.0.0.1:8000 默认情况下。
3.初始设置
当您访问 http://127.0.0.1:8000/ 您将首次看到安装向导，您需要在其中执行以下操作：
- 创建管理员用户
- 用户名 - 密码（最少8个字符，必须包括大写、小写和数字） - 密码确认
- 配置Trakt API凭据
- Trakt客户端ID - Trakt客户机密
获取您的Trakt API证书，网址：https://trakt.tv/oauth/applications
完成设置后，您将被重定向到仪表板以生成访问令牌并管理Trakt凭据。
4.使用仪表板
登录后，您将访问仪表板，在那里您可以：
生成访问令牌：
- 点击“生成新令牌”按钮
- 令牌将显示一次
- 点击“复制令牌”复制到剪贴板
- 使用此令牌访问
/mcp端点
更新Trakt凭据：
- 点击“更新trabaht凭据”按钮
- 输入新的客户端ID和客户端密码
- 出于安全考虑，从不显示当前凭据
- 点击“保存凭据”进行更新
⚠️ 安全说明:
- 仪表板不维护会话
- 刷新页面将返回登录（按设计）
- 令牌仅在明确请求时生成
- 速率限制为每小时10代代币
- 会话在1小时不活动后过期
5.后续访问
初始设置后，访问 http://127.0.0.1:8000/ 将显示一个登录页面，您可以在其中：
- 使用您的凭据登录以访问仪表板
- 按需生成新代币
- 根据需要更新Trakt凭据
- 每个令牌的有效期为365天（可配置）
- 多个令牌可以同时处于活动状态
重要提示：
- 如果您丢失了密码，请删除
data/.auth.json并重新配置 - 为了安全起见，令牌只显示一次
- 未使用会话Cookie或本地存储
配置（可选）
您可以使用环境变量自定义服务器行为：
# Server configuration
SERVER_HOST=0.0.0.0 # Default: 127.0.0.1
SERVER_PORT=8080 # Default: 8000
# Token expiration (for MCP tokens, not dashboard sessions)
TOKEN_EXPIRATION_DAYS=365 # Default: 365 days端点
网络界面
GET /-安装向导（首次）或登录页面（安装后）GET /health-使用服务器状态进行健康检查POST /setup-完成初始设置并创建管理员用户POST /login-验证和访问仪表板
API终点
POST /api/generate-token-生成新的MCP访问令牌（需要会话身份验证）POST /api/update-trakt-credentials-更新Trakt凭据（需要会话身份验证）/mcp-MCP协议端点（需要Bearer令牌）
与MCP客户端一起使用
配置您的MCP客户端以使用：
- 端点：
http://your-server:8000/mcp - 头球
Authorization: Bearer YOUR_TOKEN
安全特性
- 密码强度验证：至少8个字符，具有复杂性要求
- 速率限制:
- 登录尝试次数：每5分钟5次（15分钟锁定） - 代币生成：每位用户每小时10个
- CSRF保护：所有表单均受一次性CSRF令牌保护
- 会话管理：会话令牌（1小时）与MCP令牌分开
- 输入验证：对所有输入进行严格验证，特别是Trakt证书
- 无凭证风险：当前凭据从未显示在UI中
- XSS预防：模板自动转义和净化输入
发展
使用模型上下文协议检查器测试MCP：
npx @modelcontextprotocol/inspector许可证
麻省理工学院