AI导哈

电影比较服务

一个通过OMDb API获取真实电影数据并为电影爱好者和分析师生成视觉化对比卡片的模型上下文协议服务器。

  • by joshndala
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 joshndala/movie-mcp-server

使用说明

电影战斗MCP服务器

模型上下文协议（MCP）服务器，从OMDb API获取真实世界的电影数据，并为电影爱好者和分析师生成可视化的并排比较“作战卡片”。

特性

  • compare_movies：一个强大的工具，可以获取两个电影标题并返回一个格式精美的HTML比较卡。
  • 可视化分析：比较烂番茄评分和票房表现一目了然。
  • 动态造型：根据电影主题自动调整卡片颜色（例如，特殊的“芭比”造型）。

先决条件

  • Python 3.10+
  • OMDb API密钥：你可以在以下网址获得免费钥匙 Omdbale.com.

设置

  1. 克隆存储库:

    git clone <your-repo-url>
cd movie-mcp-server

  2. 创建虚拟环境:

    python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

  3. 安装依赖项:

    pip install -r requirements.txt

  4. 配置环境变量: 创建一个 .env 文件，并添加您的OMDb API密钥：

    OMDB_API_KEY=your_actual_api_key_here

用法

1.开发人员模式（stdio）

这是默认模式，用于与Claude Desktop或其他MCP客户端进行本地集成。

python server.py

2.网络模式（SSE）

将其用于基于web的客户端或MCP检查器。它会自动检测 PORT 环境变量（常见于Render等平台）。

python server.py --transport sse

测试与调试

使用MCP检查器

测试工具最简单的方法是 MCP检查员.

选项A：直接（stdio）

npx @modelcontextprotocol/inspector python server.py

选项B：通过苏格兰和南方能源公司

  1. 启动服务器： python server.py --transport sse
  2. 运行检查器： npx @modelcontextprotocol/inspector http://localhost:8000/sse

整合

克劳德桌面

要在Claude Desktop中使用此服务器，请将其添加到配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "movie-battle": {
      "command": "/Users/joshua_ndala/repos/movie-mcp-server/.venv/bin/python",
      "args": [
        "/Users/joshua_ndala/repos/movie-mcp-server/server.py"
      ],
      "env": {
        "OMDB_API_KEY": "your_actual_api_key_here"
      }
    }
  }
}

备注：始终使用虚拟环境python的绝对路径和 server.py 文件。

许可证

麻省理工学院

相关 MCP