关于 brainfaq-mcp
brainfaq-mcp 是用于借助 LLM 调试 Brainfuck 程序的 MCP 服务，支持逐步执行、查看解释器状态和处理输入。
主要功能
- 01按解释器设置加载代码
- 02逐条执行指令
- 03运行至结束或等待输入
- 04查看内存、指针和输出
- 05验证括号并检测单元格溢出
适用场景
- 01逐条调试 Brainfuck 程序
- 02检查循环期间的程序状态
- 03为等待字符输入的程序提供输入
MCP 相关
向 MCP 客户端提供 Brainfuck 代码加载、执行、输入及状态和输出检查工具。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
工具
6收录的工具列表 · 更新于 3 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | string | 是 | |
| maxValue | number | 否 | 磁带单元允许的最大值（默认值：9007199254740991） |
| minValue | number | 否 | 磁带单元允许的最小值（默认值：-9007199254740991） |
| tapeSize | integer | 否 | 内存磁带的大小（默认值：30000） |
| initial_input | string | 否 |
详细介绍
brainfaq-mcp
适用于 Brainfuck 编程语言的 MCP 服务，可让你喜爱的 LLM 调试 Brainfuck 程序。
用法
使用此命令运行 MCP 服务：
npx brainfaq-mcp
要在 VS Code 中使用，请将以下 JSON 代码片段添加到 .vscode/mcp.json（如果文件不存在，请创建）：
{
"servers": {
"brainfaq-mcp": {
"command": "npx",
"args": ["brainfaq-mcp"]
}
}
}
也可以通过类似方式将 MCP 添加到支持 LLM Agent 的其他 IDE（例如 Cursor）。请查阅相应文档，并将其配置为运行 npx brainfaq-mcp。这会以 stdio 模式启动 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
许可证
本仓库中的所有作品均采用“Creative Commons Attribution-ShareAlike 4.0 International License”授权。
评论
支持 Markdown
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。