English Français العربية

io.github.labarilem/brainfaq-mcp

السجل الرسمي أدوات المطورين

MCP server for the BrainFuck programming language

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع 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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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".

الأسئلة الشائعة

ما هو io.github.labarilem/brainfaq-mcp؟

MCP server for the BrainFuck programming language

كيف أثبّت io.github.labarilem/brainfaq-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add brainfaq-mcp -- npx -y brainfaq-mcp@1.0.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.labarilem/brainfaq-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.labarilem/brainfaq-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص CC-BY-SA-4.0.

من يصون io.github.labarilem/brainfaq-mcp؟

ينشره labarilem. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.