VNDB MCP Server

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

Возможности

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

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

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

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

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

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

Related MCP server: Bangumi MCP

Инструменты

Статусы

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

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

• Документация: https://api.vndb.org/kana

• Лимиты: 200 запросов / 5 минут

Требования

• Node.js >= 18.0.0

Лицензия

ISC