luadbg-mcp

Documentation

Overview

luadbg-mcp is a Model Context Protocol (MCP) debug server for the luapure Lua VM: it lets an LLM agent set breakpoints, step, inspect frames and evaluate expressions in a running Lua program through MCP tool calls. It speaks MCP over stdio (newline-delimited JSON-RPC) with no external dependencies.

luadbg-mcp                       # programs are launched with inline source
luadbg-mcp -source-dir ./scripts # resolve a program id to scripts/<id>[.lua]
luadbg-mcp -sandbox              # run debuggees without io/os/load

An MCP client (e.g. Claude Desktop/Code) spawns the binary and drives it. The debuggee's source need not live with the client: launch a program by id and the server loads it (here from -source-dir; embed the debugmcp package with your own SourceResolver to load from a database). stdout carries the protocol only — diagnostics go to stderr.