{
  "markdown": "# brainfaq-mcp\n\nMCP server for the [Brainfuck](https://esolangs.org/wiki/Brainfuck) programming language that allows your favourite LLM to debug Brainfuck programs.\n\n## Usage\n\nUse this command to run the MCP server:\n\n```\nnpx brainfaq-mcp\n```\n\nTo use it in VS Code, add the following JSON snippet to `.vscode/mcp.json` (create the file if you don't have it):\n\n```json\n{\n  \"servers\": {\n    \"brainfaq-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"brainfaq-mcp\"]\n    }\n  }\n}\n```\n\nThe 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.\n\n## Features\n\n### MCP Tools\n\n- **load_code** - Reset the debugger and load new Brainfuck source code. Supports configurable tape size, min/max cell values, and initial input.\n- **step** - Execute a specified number of instructions (default 1) with detailed state output.\n- **run** - Run the program until it finishes or waits for input, with optional instruction limit.\n- **add_input** - Append characters to the input buffer when the program is waiting for input.\n- **get_state** - Get the current interpreter state (memory, pointers, output) with optional windowing.\n- **read_output** - Get the complete output string generated so far.\n\n### Capabilities\n\n- Full Brainfuck support (8 operations: `>`, `<`, `+`, `-`, `.`, `,`, `[`, `]`)\n- Overflow/underflow detection with configurable value limits\n- Bracket matching validation and loop control\n- Step-by-step execution and debugging\n- Memory protection with configurable tape size\n\n## Development\n\nSetup:\n\n```\nnpm i\n```\n\nBuild:\n\n```\nnpm run build\n```\n\nTests:\n\n```\nnpm run test\n```\n\nTests are inspired by the [Brainfuck test suite](https://brainfuck.org/tests.b) by Daniel Cristofani.\n\n## Release\n\nBuild first the source code using the command above.\n\nLogin to NPM:\n\n```\nnpm login\n```\n\nPublish to NPM:\n\n```\nnpm publish\n```\n\n## License\n\nAll work in this repos is licensed under \"Creative Commons Attribution-ShareAlike 4.0 International License\".\n",
  "bytes": 2081,
  "sha": "92009c294cf6ae027eafcddc5fd992b7af27f6923c9f28ad3e25727dfab4820e",
  "repo_slug": "labarilem/brainfaq-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_labarilem_brainfaq_mcp_ea16c5af/readme"
}