ČSFD

ČSFD — MCP-сервер сообщества (автор — bartholomej). Фильмы, сериалы, авторы и рейтинги из чешско-словацкой базы ČSFD. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
bartholomej
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
typescript

Уровень риска: medium

Неофициальный парсер csfd.cz; только чтение публичных данных о фильмах, создателях и пользователях.

Настройка клиентов

vscode
{
    "code": "{\n  \"servers\": {\n    \"csfd\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"node-csfd-api\", \"mcp\"]\n    }\n  }\n}",
    "file": ".vscode/mcp.json",
    "lang": "json",
    "verified": "docs"
}

Неофициальный проект. Сервер не связан с ČSFD: данные берутся парсингом сайта csfd.cz, поэтому изменения на сайте могут временно ломать инструменты.

Что умеет

CSFD MCP входит в пакет node-csfd-api — современную TypeScript-библиотеку для парсинга ČSFD (csfd.cz), крупнейшей чешско-словацкой базы фильмов. В одном пакете — парсер, REST-сервер, экспорт оценок и MCP-сервер. MCP-сервер даёт ИИ-модели прямой доступ к данным ČSFD: фильмы, сериалы, создатели и пользователи.

Инструменты:

  • search — поиск фильмов, сериалов, создателей и пользователей; возвращает ID для остальных инструментов.
  • get_movie — подробности фильма или сериала по ID.
  • get_creator — данные о создателе и фильмография.
  • get_user — профиль пользователя: ник, настоящее имя, дата регистрации, итоги.
  • get_user_ratings и get_user_reviews — оценки и рецензии пользователя постранично.
  • get_cinemas — расписание сеансов в кинотеатрах.
  • get_chart — рейтинги фильмов и сериалов: лучшие, худшие, любимые, спорные.

Каждый инструмент возвращает структурированные данные с объявленной схемой вывода. Есть и готовый промпт actor-top-rated, который находит и ранжирует лучшие фильмы актёра или создателя.

Особенности пакета: типы TypeScript, покрытие тестами около 100%, работа в Node.js, браузерах и бессерверных средах, готовые Docker-образы и CLI через Homebrew. Язык названий и жанров выбирается из чешского, английского и словацкого (по умолчанию чешский). Если ČSFD просит пройти короткую проверку браузера, библиотека проходит её сама и переиспользует полученный cookie.

Кому подойдёт

  • Киноманам, которые ведут оценки на ČSFD и хотят спрашивать ИИ о фильмах и своих оценках.
  • Разработчикам, которым нужны данные ČSFD в агенте или сервисе.

Похожие серверы — в категории данные и аналитика.

Установка

Локально сервер запускается через npx -y node-csfd-api mcp или командой csfd mcp, если CLI установлен глобально. Есть HTTP-режим: REST-сервер отдаёт MCP по пути /mcp, и один экземпляр, например Docker-образ bartholomej/node-csfd-api, можно делить между клиентами. Доступ защищён тем же API_KEY, что и REST API, — он передаётся как bearer-токен.

CLI также умеет экспортировать ваши оценки в CSV, JSON и формат Letterboxd, а рецензии — в CSV и JSON.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

{
  "mcpServers": {
    "csfd": {
      "command": "npx",
      "args": ["-y", "node-csfd-api", "mcp"]
    }
  }
}

Для Claude Desktop — файл claude_desktop_config.json, для VS Code — .vscode/mcp.json в проекте. В Cursor тот же блок mcpServers, что и для Claude Desktop, кладут в ~/.cursor/mcp.json или .cursor/mcp.json.

Проверка

Спросите агента о фильме по названию: он должен вызвать search, а затем get_movie.

Примеры задач

Найди лучшие фильмы Тарантино по оценкам ČSFD.
Покажи, что идёт в кинотеатрах, и рейтинг лучших сериалов.

Риски

  • Сетевые запросы. Сервер обращается к csfd.cz; профили и оценки пользователей там публичные.
  • Ключ HTTP-режима. При общем экземпляре задайте собственный API_KEY через переменную окружения, не используйте пример из README.
  • Неофициальный парсер — возможны сбои при изменениях сайта.

Частые вопросы

Нужен ли аккаунт ČSFD?

Нет, сервер читает публичные данные.

Можно ли получать названия на английском?

Да, библиотека поддерживает языки cs, en и sk.

Может ли сервер что-то менять на ČSFD?

Нет, он только читает данные.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники