流媒体内容搜索服务

MCP JustWatch Server是一个提供流媒体内容搜索和可用性查询的服务,支持多国家多平台的电影和电视节目搜索。

  • by kkrizka
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 kkrizka/mcp-justwatch

使用说明

MCP JustWatch服务器

一种模型上下文协议(MCP)服务器,用于提供对JustWatch流可用性数据的访问。搜索电影和电视节目,找出它们可以在不同平台和国家播放的地方。

特性

  • 搜索内容:按标题和详细元数据搜索电影和电视节目
  • 流媒体可用性:获取有关可流式传输内容的全面信息
  • 多国支持:同时查询多个国家的流媒体可用性
  • 详细信息:访问IMDb/TMDb评分、流派、运行时间、发布日期等
  • 优惠详情:获取流媒体平台的定价、质量(HD/4K)和直接URL

技术栈

此服务器是使用以下方式构建的:

安装

先决条件

  • Python 3.11或更高版本
  • pip或uv包管理器

从发布

跳到“作为MCP服务器”部分,在常见的MCP客户端中自动下载包。

来源

  1. 克隆存储库:
git clone <repository-url>
cd mcp-justwatch
  1. 安装软件包:
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没有任何关联、关联、授权、认可或以任何方式正式联系。这是一个独立且非官方的项目。使用风险和自由裁量权由您自行承担。