MCP JustWatch服务器
一种模型上下文协议（MCP）服务器，用于提供对JustWatch流可用性数据的访问。搜索电影和电视节目，找出它们可以在不同平台和国家播放的地方。
特性
- 搜索内容：按标题和详细元数据搜索电影和电视节目
- 流媒体可用性：获取有关可流式传输内容的全面信息
- 多国支持：同时查询多个国家的流媒体可用性
- 详细信息：访问IMDb/TMDb评分、流派、运行时间、发布日期等
- 优惠详情：获取流媒体平台的定价、质量（HD/4K）和直接URL
技术栈
此服务器是使用以下方式构建的：
- 快速MCP：一个基于装饰器的现代框架，用于使用最少的样板构建MCP服务器
- 简单的justwatch python api：JustWatch API基于GraphQL的包装器
安装
先决条件
- Python 3.11或更高版本
- pip或uv包管理器
从发布
跳到“作为MCP服务器”部分，在常见的MCP客户端中自动下载包。
来源
- 克隆存储库：
git clone
cd mcp-justwatch- 安装软件包：
pip install -e .为了发展
使用开发依赖项进行安装：
pip install -e ".[dev]"用法
作为MCP服务器
此服务器设计用于MCP客户端。将其添加到MCP客户端配置中：
Claude桌面配置
添加到您的 claude_desktop_config.json 在会话开始时使用以下命令自动下载包 uvx.
{
"mcpServers": {
"justwatch": {
"command": "uvx",
"args": ["mcp-justwatch", "python", "-m", "mcp_justwatch.server"]
}
}
}或者，如果安装在虚拟环境中：
{
"mcpServers": {
"justwatch": {
"command": "/path/to/venv/bin/python",
"args": ["-m", "mcp_justwatch.server"]
}
}
}其他MCP主机
请参阅 mcphost-config.yaml 用于与其他MCP主机配置的示例文件。
发展
运行测试
pytest代码格式化
黑色格式代码：
black src tests带褶边的棉绒：
ruff check src tests贡献
欢迎投稿！请随时提交拉取请求。
免责声明
该项目使用 简单的justwatch python api，一个非官方的JustWatch API包装。本API与JustWatch没有任何关联、关联、授权、认可或以任何方式正式联系。这是一个独立且非官方的项目。使用风险和自由裁量权由您自行承担。