Summary
Provides a complete debugging environment for Brainfuck programs through six MCP tools. You can load code with configurable tape size and cell value limits, step through execution instruction by instruction, run until completion or input wait, and inspect memory state with windowing. The server handles all eight Brainfuck operations, validates bracket matching, detects overflow and underflow, and manages input/output buffers. Reach for this when you need an LLM to debug or analyze Brainfuck code, whether you're learning esoteric languages, building interpreters, or just need to figure out why your bracket loops aren't behaving.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →brainfaq-mcp
MCP server for the Brainfuck programming language that allows your favourite LLM to debug Brainfuck programs.
Usage
Use this command to run the MCP server:
npx brainfaq-mcp
To use it in VS Code, add the following JSON snippet to .vscode/mcp.json (create the file if you don't have it):
{
"servers": {
"brainfaq-mcp": {
"command": "npx",
"args": ["brainfaq-mcp"]
}
}
}
The MCP can be added to other IDEs with LLM agents support (e.g. Cursor) in similar ways. Check their documentation and configure them to run npx brainfaq-mcp. It will start the MCP server in stdio mode.
Features
MCP Tools
- load_code - Reset the debugger and load new Brainfuck source code. Supports configurable tape size, min/max cell values, and initial input.
- step - Execute a specified number of instructions (default 1) with detailed state output.
- run - Run the program until it finishes or waits for input, with optional instruction limit.
- add_input - Append characters to the input buffer when the program is waiting for input.
- get_state - Get the current interpreter state (memory, pointers, output) with optional windowing.
- read_output - Get the complete output string generated so far.
Capabilities
- Full Brainfuck support (8 operations:
>,<,+,-,.,,,[,]) - Overflow/underflow detection with configurable value limits
- Bracket matching validation and loop control
- Step-by-step execution and debugging
- Memory protection with configurable tape size
Development
Setup:
npm i
Build:
npm run build
Tests:
npm run test
Tests are inspired by the Brainfuck test suite by Daniel Cristofani.
Release
Build first the source code using the command above.
Login to NPM:
npm login
Publish to NPM:
npm publish
License
All work in this repos is licensed under "Creative Commons Attribution-ShareAlike 4.0 International License".
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →