Brainfaq Mcp

io.github.labarilemPublished by GitHub account labarilemv1.0.0Updated Oct 27, 2026

MCP server for the BrainFuck programming language

VerifiedSTDIODesktop onlyDeveloper ToolsAI & ML

Overview

AI-generated overview

Local MCP server that lets an assistant load, step through, and debug Brainfuck programs in an interpreter.

What you can do
  • Load and reset Brainfuck source code with configurable tape size, cell limits and initial input
  • Step through a set number of instructions and inspect detailed interpreter state
  • Run a program to completion or until it waits for input, with an optional instruction limit
  • Append characters to the input buffer when the program is waiting for input
  • Read current memory, pointers and output, or fetch the full output produced so far
When to use it
Useful when you want an assistant to trace, test or explain small Brainfuck programs step by step instead of reasoning about them by hand, for example while learning the language or checking a program's memory and output behavior.
Requirements
Runs as a local stdio process, started with npx brainfaq-mcp, so Node.js and npm are needed. No accounts, API keys, environment variables or headers are declared.
Before you install
It only interprets Brainfuck code in a local sandboxed interpreter; the README does not describe file access, network calls or data sent to third parties. Loading new code resets the debugger state, discarding the current session.

Installation

In SourceWeft

  1. Open Brainfaq Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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):

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

Source: README.md at commit 7b33f0b

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts