Brainfaq MCP

🚀 brainfaq-mcp

Brainfaq-mcp 是一个用于 Brainfuck 编程语言的 MCP 服务器，它能让你喜爱的大语言模型（LLM）对 Brainfuck 程序进行调试。

🚀 快速开始

运行 MCP 服务器

使用以下命令运行 MCP 服务器：

npx brainfaq-mcp

在 VS Code 中使用

将以下 JSON 代码片段添加到 .vscode/mcp.json 文件中（如果该文件不存在则创建它）：

{
  "servers": {
    "brainfaq-mcp": {
      "command": "npx",
      "args": ["brainfaq-mcp"]
    }
  }
}

在其他 IDE 中使用

该 MCP 可以通过类似的方式添加到其他支持 LLM 代理的 IDE（如 Cursor）中。查阅它们的文档并将其配置为运行 npx brainfaq-mcp，这将以标准输入输出模式启动 MCP 服务器。

✨ 主要特性

MCP 工具

• load_code - 重置调试器并加载新的 Brainfuck 源代码。支持可配置的磁带大小、最小/最大单元值和初始输入。
• step - 执行指定数量的指令（默认 1 条），并输出详细的状态信息。
• run - 运行程序，直到程序结束或等待输入，可选择设置指令执行上限。
• add_input - 当程序等待输入时，向输入缓冲区追加字符。
• get_state - 获取当前解释器的状态（内存、指针、输出），可选择设置窗口范围。
• read_output - 获取到目前为止生成的完整输出字符串。

功能特点

• 全面支持 Brainfuck 语言（8 种操作：>, <, +, -, ., ,, [, ]）
• 支持可配置值限制的溢出/下溢检测
• 括号匹配验证和循环控制
• 支持逐步执行和调试
• 支持可配置磁带大小的内存保护

📦 安装指南

项目设置

npm i

项目构建

npm run build

运行测试

npm run test

测试灵感来源于 Daniel Cristofani 的 Brainfuck 测试套件。

🚀 发布流程

首先使用上述命令构建源代码。

登录 NPM：

npm login

发布到 NPM：

npm publish

📄 许可证

本仓库中的所有作品均遵循“知识共享署名 - 相同方式共享 4.0 国际许可协议”。