Brainfaq MCP

🚀 brainfaq-mcp

Brainfuckプログラミング言語用のMCPサーバーで、お気に入りのLLMがBrainfuckプログラムのデバッグを行えるようにします。

🚀 クイックスタート

サーバーの起動

MCPサーバーを実行するには、次のコマンドを使用します。

npx brainfaq-mcp

VS Codeでの使用方法

VS Codeで使用するには、次のJSONスニペットを.vscode/mcp.jsonに追加してください（ファイルがない場合は作成してください）。

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

他のIDEでの使用方法

LLMエージェントをサポートする他のIDE（例: Cursor）にも同様の方法でMCPを追加できます。それぞれのドキュメントを確認し、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テストスイートに触発されています。

📄 ライセンス

このリポジトリ内のすべての作品は、「Creative Commons Attribution-ShareAlike 4.0 International License」の下でライセンスされています。