MCP-сервер

Дайте ИИ-ассистенту живой доступ к javinfo с помощью @javinfo/mcp — stdio MCP-сервер, предоставляющий поиск и поиск фильмов как инструменты.

@javinfo/mcp — это Model Context Protocol сервер (stdio), который оборачивает API javinfo. Подключите к нему любой MCP-клиент — Claude Desktop, Claude Code, Cursor, VS Code — и ассистент сам сможет искать тайтлы и получать полные записи. Те же данные, что и в REST API, без клеящего кода.

Настройка

Серверу нужен ваш ключ jvi_ в переменной окружения JAVINFO_API_KEY. Получите его в панели управления — см. Аутентификацию.

Добавьте его в конфигурацию MCP вашего клиента. Это стандартная форма mcpServers (её используют Claude Desktop, Cursor, VS Code и Claude Code):

mcp.json

{
  "mcpServers": {
    "javinfo": {
      "command": "npx",
      "args": ["-y", "@javinfo/mcp"],
      "env": { "JAVINFO_API_KEY": "jvi_your_key_here" }
    }
  }
}

npx -y загружает и запускает последнюю опубликованную версию — без глобальной установки. Перезапустите клиент, и появятся инструменты javinfo-search / javinfo-movie.

Ключ хранится в открытом виде в конфигурации клиента. Держите этот файл в тайне — он тарифицируется за каждый успешный поиск, как и REST API. См. лимиты и тарификацию.

Инструменты

Два инструмента, предназначенных для совместной работы: поиск, чтобы найти точный DVD-код, а затем получение его полной записи.

`javinfo-search`

Поиск по DVD-коду, названию или актрисе. Возвращает компактный список совпадений.

Аргумент	Тип	Примечания
`q`	string, обязательный	Код, название или имя актрисы — например `AVSA-210`.
`providers`	string или массив, необязательный	Ограничить источники. `fanza`, `dmm`, `missav`, `javdatabase`. По умолчанию все.

javdb здесь недоступен (только по коду) — используйте javinfo-movie для ссылок на скачивание.

`javinfo-movie`

Получает одну полную запись по точному DVD id (тому, что вы получили при поиске).

Аргумент	Тип	Примечания
`q`	string, обязательный	Точный DVD id — например `AVSA-210`.
`providers`	string или массив, необязательный	`fanza`, `dmm`, `javdb`, `missav`, `javdatabase`. По умолчанию все.
`includeImages`	boolean, необязательный	Добавить URL обложки, примеров и галереи. По умолчанию `false`.

URL изображений по умолчанию опускаются, чтобы ответы были компактными — установите includeImages: true, когда они действительно нужны. Каждый результат также несёт сырую запись в structuredContent для клиентов, читающих структурированный вывод инструментов.

Провайдеры

providers закрепляет, откуда берутся данные. Опустите его, чтобы выполнить веерный запрос ко всем и взять первое совпадение.

Провайдер	Даёт вам	Где
`fanza`, `dmm`	Метаданные (также полнотекстовый поиск)	search + movie
`javdb`	Ссылки для скачивания и magnet	только movie
`missav`	URL-адреса потоков `.m3u8`	search + movie
`javdatabase`	Описание и примеры изображений	search + movie

Рабочий процесс

Сначала поиск, затем детали — паттерн resolve → fetch:

javinfo-search с q: "AVSA" (или именем актрисы) → список совпадений с DVD id.
javinfo-movie с q: "AVSA-210" → полная запись. Закрепите providers: "javdb" для magnet-ссылок, "missav" для потоков.

Локальная разработка

Запустите сервер из исходников с MCP Inspector:

npm install
npm run build
JAVINFO_API_KEY=jvi_your_key_here npx @modelcontextprotocol/inspector node dist/index.js

Предпочитаете вызывать API напрямую? Пропустите сервер и используйте REST-эндпоинты.

Сделайте её своей

Этот сервер — open source (MIT). Мы упустили функцию, которая вам нужна? Настройте его. Pull request приветствуются, а можно и форкнуть проект, сделав его своим. Забирайте исходный код: github.com/javinfo/mcp.

MCP-сервер

On this page