Files in the top-level directory from the latest check-in
- nuklear_mcp
- nuklear_sdl2_gl_mcp.egg-info
- bootstrap.sh
- pyproject.toml
- README.md
nuklear-sdl2-gl-mcp
MCP server giving agents deep, correct, lean expertise for building UIs with:
- Nuklear (immediate mode)
- SDL2 (window, input, GL context)
- OpenGL (render)
- Specifically via the excellent
nsauzede/vnk+nsauzede/vsdl2V modules.
Primary consumer: MaxMinion spreadsheet (Multiplan CTOS keyboard soul + virtual grid).
The MCP (and its resources) encode hard-won patterns for:
- Pure keyboard navigation (no mouse required)
- Mode machine: Ready / Edit / Command (status bar, command bar at bottom like classic)
- Virtual grid rendering (only draw visible cells queried from SQLite)
- Raw SDL event handling layered with/around nk input for arrow keys, Ctrl+arrows, function keys, etc.
- Dark, high-contrast, minimalist 80s-pro aesthetic (clean borders, excellent readability)
- Static linking recipes for single-exe deployment (tcc/gcc + amalgam SDL where possible + sqlite)
This repo is a standalone Fossil so the knowledge and helpers can be reused/extracted for any V + vnk project.
Usage from agent
Connect the MCP, then ask it for "Multiplan grid in vnk", "static SDL2 build on linux", "keyboard mode dispatch table" etc. It will return production-ready V snippets + explanations.
Bootstrap
Same as fossil-scm-mcp: ./bootstrap.sh .venv/bin/python -m nuklear_mcp
or from the MaxMinion checkout root:
./mcp/run-nuklear-mcp.sh
See the parent MaxMinion mcp/MCP-INTEGRATION.md (and example-mcp-config.json) for connection and usage instructions when developing the spreadsheet UI.