Skip to main content
Glama
VNDB MCP Server

VNDB MCP Server

by ivanmem

VNDB MCP Server

CI License: ISC

MCP-сервер для управления списком визуальных новелл на VNDB.org.

Возможности

  • 🔍 Поиск ВН по названию (поддерживает русские названия) или ID

  • ➕ Добавление в списки с различными статусами

  • 📝 Установка оценок и заметок

  • 📋 Просмотр списка пользователя

  • 🔄 Изменение статуса (Playing → Finished и т.д.)

  • ❌ Удаление из списка

Related MCP server: AniList MCP Server

Инструменты

Инструмент

Описание

search_vn

Поиск ВН по названию или ID

add_vn_to_list

Добавить ВН в список со статусом

update_vn_status

Изменить статус ВН в списке

remove_vn_from_list

Удалить ВН из списка

get_vn_list

Получить список ВН пользователя

check_auth

Проверка подключения и авторизации

Статусы

Статус

Описание

playing

🎮 В процессе

finished

✅ Завершено

stalled

⏸️ Приостановлено

dropped

❌ Брошено

planning

📋 Запланировано

Быстрый старт

1. Получение токена VNDB

  1. Откройте https://vndb.org/u/tokens

  2. Войдите в свой аккаунт

  3. Создайте новый токен с разрешениями:

    • listread — чтение списков

    • listwrite — запись в списки

2. Установка токена

Способ 1: Через .env файл

Создайте файл .env в корне проекта:

VNDB_TOKEN=ваш-токен-здесь

Способ 2: В mcp.json

Откройте mcp.json и укажите токен в env:

{
  "mcpServers": {
    "vndb": {
      "command": "node",
      "args": ["путь/к/server.js"],
      "env": {
        "VNDB_TOKEN": "ваш-токен-здесь"
      }
    }
  }
}

3. Установка зависимостей

npm install

4. Запуск

npm start

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

Claude Desktop

Windows: %APPDATA%\Claude\claude_desktop_config.json
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "vndb": {
      "command": "node",
      "args": ["C:\\путь\\к\\vndb-mcp\\server.js"],
      "env": {
        "VNDB_TOKEN": "ваш-токен"
      }
    }
  }
}

VS Code

  1. Установите расширение MCP

  2. Откройте настройки MCP (Ctrl+Shift+P → "MCP: Open Configuration")

  3. Добавьте сервер:

{
  "mcpServers": {
    "vndb": {
      "command": "node",
      "args": ["${workspaceFolder}/server.js"],
      "env": {
        "VNDB_TOKEN": "ваш-токен"
      }
    }
  }
}

Cursor

  1. Откройте настройки MCP

  2. Добавьте сервер с путём к server.js

  3. Укажите VNDB_TOKEN в переменных окружения

Примеры использования

Поиск новеллы

Найди новеллу "Steins;Gate"

Добавление в список

Добавь "Бесконечное лето" в завершённые, оценка 8/10

Изменение статуса

Перемести "Clannad" в "В процессе"

Просмотр списка

Покажи мой список завершённых новелл

Поиск по русским названиям

Сервер автоматически ищет ВН по русскому названию через VNDB API.
Для точного поиска используйте оригинальное название или ID (например, v123).

API VNDB

Требования

  • Node.js >= 18.0.0

Лицензия

ISC

Available Tools

6 tools
add_vn_to_listДобавить ВН в списокA

Добавляет визуальную новеллу в список пользователя на VNDB с указанным статусом. Автоматически ищет ВН по названию (поддерживает русские названия), затем добавляет в список.

Inputs: status (required), vnName (required), vote, notes.

check_authПроверить авторизациюA

Проверяет подключение к VNDB API и получает информацию о текущем пользователе.

Inputs: no named parameters.

get_vn_listПолучить список ВНA

Получает список визуальных новелл пользователя с указанным статусом.

Inputs: limit, status.

remove_vn_from_listУдалить ВН из спискаA

Удаляет визуальную новеллу из списка пользователя на VNDB.

Inputs: vnId (required).

search_vnПоиск ВНA

Ищет визуальную новеллу на VNDB по названию (поддерживает русские названия) или ID. Возвращает информацию о найденных ВН.

Inputs: query (required).

update_vn_statusОбновить статус ВНB

Изменяет статус визуальной новеллы в списке пользователя. Например, переместить из "В процессе" в "Завершено".

Inputs: vnId (required), status (required), vote, notes.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a distinct purpose: searching, adding, removing, updating status, retrieving the user's list, and checking authentication. There is no meaningful overlap between them.

    Naming Consistency5/5

    All tool names follow a consistent snake_case verb_noun pattern (e.g., search_vn, add_vn_to_list, update_vn_status), with minor prepositions that do not break uniformity.

    Tool Count5/5

    Six tools cover the core operations of a VN list management server without being excessive or sparse. Each tool serves a clear, necessary function.

    Completeness5/5

    The set provides full lifecycle coverage for a user's VN list: search, add, remove, update status, and retrieve the list, plus authentication. There are no obvious gaps for the stated purpose.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables searching and browsing anime/manga, characters, staff, and more on AniList without credentials, and with a one-time login allows managing personal lists, favorites, follows, and activity.
      50
      86 npm
      2
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables querying and updating Bangumi anime collections, tracking per-episode progress, and receiving airing reminders for currently-watching anime via AniList.
      -