Skip to content

jdBasic now speaks MCP — persistent VM for any AI agent

Pre-release
Pre-release

Choose a tag to compare

@AtomiJD AtomiJD released this 01 May 15:27
· 985 commits to main since this release

jdBasic doubles as a Model Context Protocol server - every MCP-aware client
(Claude Desktop, Claude Code, Cursor, Cline, Continue, Zed, Windsurf,
ChatGPT Desktop) can drive jdBasic's persistent VM directly: run code,
compile it to a standalone Windows EXE, and even pause a running program to
live-tweak it and resume.

What's new

  • jdBasic.exe --mcp (stdio) and --mcp-http 7321 (HTTP) transports.
  • 14 tools: jdb_eval, jdb_check, jdb_doc, jdb_vars, jdb_funcs,
    jdb_load, jdb_loadws, jdb_savews, jdb_run_native, jdb_recompile,
    jdb_stop, jdb_resume, jdb_status, echo.
  • Persistent VM - variables and FUNC definitions survive across tool
    calls within one session. Most code-execution MCP servers fork a fresh
    process per call; this one doesn't.
  • Live pair-coding - jdb_stop / jdb_resume / jdb_recompile let an
    agent freeze a running script, inspect or mutate its state with jdb_eval,
    swap in new code, and resume, without restarting the program.
  • jdb_doc - substring lookup against the bundled language reference.
    Catches "model invented a builtin name" before jdb_eval ever runs it.
  • jdb_run_native - compiles a .jdb to a standalone Windows EXE via the
    embedded LLVM-18 backend. A small binary plus a runtime DLL, droppable on a
    USB stick, no setup on the target machine.

Assets (Build 82; VB6 Pack Build 84)

  • jdbasic-core-windows-x64.zip (~4.0 MB) - interpreter + MCP server, no LLVM
    dependency. doc/languages.md ships alongside the EXE so jdb_doc works
    out of the box.
    sha256 DAD368458543E6ECE57EA8CDCFE34F24B8594A6B5C8C0B0773065EE3E1D92217
  • jdbasic-mcp-native-windows-x64.zip (~34.5 MB) - Core plus the LLVM-18
    backend for jdb_run_native. The bundle ships LLVM, but the final link
    shells out to your local MSVC: install Visual Studio 2022 17.10+ (Community
    is fine) with the "Desktop development with C++" workload.
    sha256 E9E093A10E23EFF87CFD999FD51BC8D2C21D06FFCD251CCB6B148699E715331C
  • jdbasic-vibe-game-pack-windows-x64.zip (~8.7 MB) - GFX/ImGui build with
    ready-to-run games (Pac-clone, vector shooter, empty canvas), launchers and
    a Claude-Code pair-coding quickstart. Embedded SQLite (SQL.*) for
    highscores and save state, plus WAV I/O and the effects chain
    (WAV.*, FX.*).
    sha256 DCAA8E3FD1E1625B648B74A8301BB04C6DD5D59DE55F589F4C0840937BDBAEEA
  • jdbasic-vb6-windows-x64.zip (~8.7 MB) - VB6 Pack: native Win32 forms
    (FORM.*), COM automation (CREATEOBJECT), embedded SQLite (SQL.*),
    plus GFX/ImGui/HTTP and the MCP server. Ships forms demos incl. .jdform
    layouts from the VS Code visual designer.
    sha256 A0E138DE57D9880C45D8DDC4843BE358290E23F05B88433353B6B8C5B0609EA5

Setup: see doc/MCP.md for client configs.