vndb/kana-mcp
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
MCP server for Kana API
4 commits 1 branch 0 tags 52 KiB
  • Python 86.7%
  • Nix 13.3%
Find a file
Exact
Aleksandr 3d37983c64 Tighten server instructions 
Co-Authored-By: Eva
2026-07-13 21:36:43 +03:00
src/kana_mcp Tighten server instructions 2026-07-13 21:36:43 +03:00
.gitignore Initial vndb-mcp: MCP server for the VNDB kana API 2026-07-13 21:27:23 +03:00
flake.lock Initial vndb-mcp: MCP server for the VNDB kana API 2026-07-13 21:27:23 +03:00
flake.nix Rename vndb-mcp to kana-mcp 2026-07-13 21:32:45 +03:00
pyproject.toml Rename vndb-mcp to kana-mcp 2026-07-13 21:32:45 +03:00
README.md Rename vndb-mcp to kana-mcp 2026-07-13 21:32:45 +03:00

README.md

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

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