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 國際許可協議”。