MCP server for the BrainFuck programming language
npm install brainfaq-mcp
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):
`json
{
"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
$3
- 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.
$3
- 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
``