Summary
A real debugger for Brainfuck, not just an interpreter.
The state is what makes it useful: after every step you can read memory, both pointers and the output so far, with a window around the pointer when the whole tape is too much. `run` executes to completion and an infinite loop will hang the server, so pass it the instruction limit, or step a fixed count instead.
What it is
A Node server that is a Brainfuck interpreter with its debugger exposed: load source, step or run it, feed it input, and read memory, pointers and output at any point.
What you get
- Source loaded with a configurable tape size, min/max cell values and initial input, resetting the debugger
- A chosen number of instructions executed, with a state summary after each stop
- The program run to completion or until it blocks on input, with an optional instruction limit
- Characters appended to the input buffer while the program is waiting for them
- Full state — memory, pointers, output — or just a window of cells around the pointer
- The output string produced so far, on its own
- Overflow and underflow detection, and bracket matching validated before execution
Requirements
Npx — `npx brainfaq-mcp` starts it in stdio mode, which is all any client config needs. Licensed CC BY-SA 4.0.
Setup effort
One command — npx -y brainfaq-mcp