English Français العربية

io.github.labarilem/brainfaq-mcp

Official registry Developer tools

MCP server for the BrainFuck programming language

Source code Documentation

What can you do with io.github.labarilem/brainfaq-mcp?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package brainfaq-mcp
Claude Code 
claude mcp add brainfaq-mcp -- npx -y brainfaq-mcp@1.0.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "brainfaq-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "brainfaq-mcp@1.0.2"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. brainfaq-mcp
  2. Usage
  3. Features
  4. Development
  5. Release
  6. License

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".

Frequently asked questions

What is io.github.labarilem/brainfaq-mcp?

MCP server for the BrainFuck programming language

How do I install io.github.labarilem/brainfaq-mcp?

It runs on your machine. In Claude Code: claude mcp add brainfaq-mcp -- npx -y brainfaq-mcp@1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.labarilem/brainfaq-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.labarilem/brainfaq-mcp open source?

Yes. Its code is on GitHub under the CC-BY-SA-4.0 license.

Who maintains io.github.labarilem/brainfaq-mcp?

It is published by labarilem. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.