letterboxd-mcp

一个 MCP 服务器，将 Letterboxd 用户的观影历史提供给 LLM，让模型能读取你看过的内容，并推荐真正符合你口味的新电影。

为什么用 RSS？

Letterboxd 没有官方的公开 API。每个用户的 RSS 订阅源（https://letterboxd.com/{username}/rss/）是唯一官方认可的机器可读接口，因此本服务器会解析它。无需爬取，无需登录。

注意：该订阅源只包含最近 ~50 条日记条目。

Related MCP server: Filmladder MCP Server

工具

前提条件

影片必须记录在你的日记中，订阅源才会采集到这些信息。在电影页面上打星评分则不行；它永远也不会进入订阅源。请改用 Log/Review 流程并在其中设置你的评分。影评正文可选。

书写文字影评仍有帮助，哪怕只有一句话。评分让模型知道你看了什么；影评让模型知道你为何喜欢或不喜欢某部影片，而后者正是让它的推荐变得有价值的关键。

安装

需要安装 uv。

uv sync
uv run python test_server.py   # self-check against bundled fixtures
uv run python smoke.py <your_username>  # live end-to-end check

MCP 客户端注册

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