kana-mcp

MCP server for the VNDB HTTPS API (kana).

Tools

• vndb_query — query any entity (vn, release, producer, character, staff, tag, trait, quote, ulist) with kana filters, field selection, sorting and pagination
• vndb_stats, vndb_user, vndb_authinfo, vndb_ulist_labels
• vndb_ulist_update / vndb_ulist_remove — manage the user's VN list
• vndb_rlist_update / vndb_rlist_remove — manage the user's release list

Each tool exposes _meta in the tools/list response with dev.eva/icon (emoji) and, where applicable, dev.eva/brief (input template string).

Configuration

• VNDB_API_TOKEN — optional; required for authinfo and list writes. Get one at https://vndb.org → My Profile → Applications.
• VNDB_API_URL — override the API base (e.g. the beta sandbox https://beta.vndb.org/api/kana).

Usage

nix run .   # stdio MCP server

Claude Code:

claude mcp add vndb -e VNDB_API_TOKEN=... -- nix run /path/to/kana-mcp