MCP Server Imdb

FM-DB MCP 服务器

一个与FM-DB API（免费电影数据库）集成的模型上下文协议（MCP）服务器，用于提供来自IMDb的电影和电视节目信息。

特点/功能

这个MCP服务器提供了三种工具，用于与FM-DB API进行交互：

🔍 搜索电影

在IMDb上搜索电影和电视节目，或获取特定标题的详细信息。

参数：

• q （可选）：搜索查询 - 要搜索的单词或短语
• tt （可选）：IMDb ID 以获取详细信息
• lsn （可选）：季数 - 如果IMDb ID是电视剧，则获取该季的剧集

注： 至少其中一个 q 或者 tt 必须提供。

示例：

# Search by title
search_movies(q="The Dark Knight")

# Get details by IMDb ID
search_movies(tt="tt0468569")

# Get TV series season episodes
search_movies(tt="tt0944947", lsn=1)  # Game of Thrones Season 1

🖼️ 获取电影海报

获取电影或电视节目的海报图片URL。

参数：

• imdb_idIMDb编号（例如，《黑客帝国》的编号为“tt0133093”）

示例：

get_movie_poster(imdb_id="tt0133093")

🎬 获取电影预告片

获取电影或电视节目的预告片视频URL。

参数：

• imdb_idIMDb编号（例如，《黑客帝国》的编号为“tt0133093”）

示例：

get_movie_trailer(imdb_id="tt0133093")

安装

1. 确保已安装 Python 3.12 或更高版本
2. 安装依赖项：

uv pip install -e .

用法

运行服务器

使用FastMCP运行服务器：

# Using uv (recommended)
uv run run_server.py

# Or run directly
python3 run_server.py

测试服务器

您可以使用随附的测试脚本来测试服务器功能：

uv run test_server.py

连接到MCP客户端

Claude Desktop（中文可译为“克劳德桌面版”或根据具体语境简化为“克劳德桌面”，但通常保留原名以体现品牌特色）

把它加到你的（列表/计划/等）里 claude_desktop_config.json:

{
  "mcpServers": {
    "fm-db": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-server",
        "run",
        "run_server.py"
      ]
    }
  }
}

替换 /path/to/mcp-server 附上此目录的实际路径。

其他MCP客户端

此服务器使用标准MCP协议，并且可以连接到任何支持STDIO传输的MCP兼容客户端。

API 信息

此服务器使用FM-DB API（免费电影数据库）：

• 基本网址： 该网址（https://imdb.iamidiotareyoutoo.com）的中文翻译可以是：“https://互联网电影数据库（IMDb）我是个笨蛋你也是吗.com”。不过，需要注意的是，这个网址看起来像是一个恶作剧或玩笑性质的网站，它并不是IMDb的官方网址。在实际使用中，应避免访问此类非官方或具有误导性的网址
• 文档： 该网址的中文翻译可以是：“https://imdb.iamidiotareyoutoo.com/文档/索引.html” 或者更简洁地表达为：“IMDB自嘲网站文档索引页”。不过，需要注意的是，这个网址看起来像是一个自嘲或恶搞性质的网站（基于域名中的“iamidiotareyoutoo”部分），它并不是IMDB（互联网电影数据库）的官方网址，因此在实际使用中应谨慎对待，避免误导
• 许可证： GNU 附带条件的通用公共许可证 3.0

所有内容和图片均由FM-DB用户贡献和维护。无需API密钥。

发展

项目结构

mcp-server/
├── main.py              # MCP server implementation
├── pyproject.toml       # Project dependencies
└── README.md           # This file

依赖项

• mcp>=1.17.0 - 模型上下文协议SDK
• httpx>=0.27.0 用于API请求的HTTP客户端

示例用例

1. 电影搜索： 按标题、演员、导演或关键词查找电影
2. 详细信息： 获取特定电影或电视节目的详细信息
3. 电视剧集数： 获取特定季节的剧集列表
4. 视觉资产： 获取电影和节目的海报图片
5. 预告片： 访问宣传内容的预告片视频

许可证

本项目遵循FM-DB API的许可协议（GNU Affero通用公共许可证3.0）。

支持

对于问题或功能请求：

• FM-DB API：https://github.com/TelegramPlayGround/Unofficial-IMDb-API/issues
• MCP协议：https://modelcontextprotocol.io