io.github.labarilem/brainfaq-mcp
MCP server for the BrainFuck programming language
Que pouvez-vous faire avec 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
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
brainfaq-mcpclaude mcp add brainfaq-mcp -- npx -y brainfaq-mcp@1.0.2
{
"mcpServers": {
"brainfaq-mcp": {
"command": "npx",
"args": [
"-y",
"brainfaq-mcp@1.0.2"
]
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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".
Questions fréquentes
Qu'est-ce que io.github.labarilem/brainfaq-mcp ?
MCP server for the BrainFuck programming language
Comment installer io.github.labarilem/brainfaq-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add brainfaq-mcp -- npx -y brainfaq-mcp@1.0.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.labarilem/brainfaq-mcp ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.github.labarilem/brainfaq-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence CC-BY-SA-4.0.
Qui maintient io.github.labarilem/brainfaq-mcp ?
Il est publié par labarilem. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.