VNDB MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@VNDB MCP Server Show my currently playing visual novels."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
VNDB MCP Server
MCP-сервер для управления списком визуальных новелл на VNDB.org.
Возможности
🔍 Поиск ВН по названию (поддерживает русские названия) или ID
➕ Добавление в списки с различными статусами
📝 Установка оценок и заметок
📋 Просмотр списка пользователя
🔄 Изменение статуса (Playing → Finished и т.д.)
❌ Удаление из списка
Related MCP server: AniList MCP Server
Инструменты
Инструмент | Описание |
| Поиск ВН по названию или ID |
| Добавить ВН в список со статусом |
| Изменить статус ВН в списке |
| Удалить ВН из списка |
| Получить список ВН пользователя |
| Проверка подключения и авторизации |
Статусы
Статус | Описание |
| 🎮 В процессе |
| ✅ Завершено |
| ⏸️ Приостановлено |
| ❌ Брошено |
| 📋 Запланировано |
Быстрый старт
1. Получение токена VNDB
Откройте https://vndb.org/u/tokens
Войдите в свой аккаунт
Создайте новый токен с разрешениями:
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 install4. Запуск
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
Установите расширение MCP
Откройте настройки MCP (
Ctrl+Shift+P→ "MCP: Open Configuration")Добавьте сервер:
{
"mcpServers": {
"vndb": {
"command": "node",
"args": ["${workspaceFolder}/server.js"],
"env": {
"VNDB_TOKEN": "ваш-токен"
}
}
}
}Cursor
Откройте настройки MCP
Добавьте сервер с путём к
server.jsУкажите
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
Available Tools
6 toolsadd_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
Scored across 6 tools
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.
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.
Six tools cover the core operations of a VN list management server without being excessive or sparse. Each tool serves a clear, necessary function.
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
Search, browse, and summarize private notes, transcripts, and knowledge from Vbnote.
Save, search and edit your private notes by talking to your AI assistant.
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Read and write the notes and folders of your Grape account, the AI note-taking app.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with MyAnimeList user accounts for list management, progress tracking, and personalized anime recommendations.11MIT
- AlicenseAqualityBmaintenanceEnables 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.5086 npm2MIT
- AlicenseAqualityDmaintenanceEnables AI clients to search, inspect, rank, and manage MyAnimeList anime and manga, including authenticated user list operations.15MIT
- FlicenseNot gradedqualityDmaintenanceEnables querying and updating Bangumi anime collections, tracking per-episode progress, and receiving airing reminders for currently-watching anime via AniList.-