letterboxd-mcp

Letterboxd 사용자의 시청 기록을 LLM에 공급하는 MCP 서버입니다. 모델이 당신이 본 영화를 읽고, 실제로 좋아할 만한 새 영화를 추천할 수 있게 해 줍니다.

왜 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"]
    }
  }
}