Log inSubmit server
Brainfaq MCP logo

Brainfaq MCP

MCP server for the BrainFuck programming language

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Brainfaq MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "brainfaq-mcp": {
      "command": "npx",
      "args": [
        "brainfaq-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 6 tools correctly (4d ago).

Overview

Tools6

What Brainfaq MCP lets your agent do. Expand a tool for its parameters.

Verified live~509 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

9/9 checks healthy over the last 47d

What it can do

From the 6 tools this server returned when we ran it.

Runs commands · 1Read-only tools · 5
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age280 days
Maintainers1

Observed 2026-10-25 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2d ago via OSV.dev · brainfaq-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads135Package downloads in the last 30 days.
Last commit6mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed6Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

From the project 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:

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

config.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:

Terminal
npm i

Build:

Terminal
npm run build

Tests:

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

Terminal
npm login

Publish to NPM:

Terminal
npm publish

License

All work in this repos is licensed under "Creative Commons Attribution-ShareAlike 4.0 International License".

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Brainfaq MCP

brainfaq-mcp is an MCP server that lets an LLM debug and execute Brainfuck programs through a stateful interpreter. It supports all eight Brainfuck operations, step-by-step execution, loop and bracket validation, configurable tape size and cell value limits, input buffering, output inspection, and memory state queries.

Run brainfaq-mcp with npx using the command `npx brainfaq-mcp`. It starts the MCP server in stdio mode and can be configured in VS Code or other IDEs with LLM agent support by setting the server command to `npx` and its argument to `brainfaq-mcp`.

brainfaq-mcp provides tools to load code, step through instructions, run programs, add input, inspect interpreter state, and read generated output. The `load_code` tool resets the debugger, while `step`, `run`, `add_input`, `get_state`, and `read_output` control or inspect execution.

brainfaq-mcp detects overflow and underflow using configurable cell value limits, validates Brainfuck bracket matching, and protects memory with a configurable tape size. Its step and run tools also support controlled execution, including an optional instruction limit for `run`.

Related MCP servers

All in Code Execution All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewBrainfaq MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/brainfaq-mcp?style=directory)](https://allmcps.com/mcp/brainfaq-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/brainfaq-mcp"><img src="https://allmcps.com/api/badge/brainfaq-mcp?style=directory" alt="Brainfaq MCP on AllMCPs" /></a>