io.github.labarilem/brainfaq-mcp
MCP server for the BrainFuck programming language
Open source Open in the app JSON README (API)
About
MCP server for the BrainFuck programming language
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- labarilem
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.0
- Open pull requests
- 6
- Last push
- 2026-04-16T02:04:56Z
- Repository state
- ativo
- Language
- TypeScript
- License
- CC-BY-SA-4.0
- Added
- 2026-08-29 04:00:22
- Updated
- 2026-08-29 04:00:22
- Origin id
io.github.labarilem/brainfaq-mcp
README
# brainfaq-mcp
MCP server for the [Brainfuck](https://esolangs.org/wiki/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):
```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
### 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](https://brainfuck.org/tests.b) 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".