build82

build82

🌐 言語： 英語 · ポルトガル語

MCP（Model Context Protocol）サーバーです。Moodle のインストール環境とプラグインの構造を AI アシスタントが理解できるようにし、コードベースに関する質問への回答や、実際の規約に沿ったプラグインの開発を支援します。単一の静的バイナリとして配布されます。

目次

• 概要
• 前提条件と簡単なインストール
• クライアントのセットアップ
• 更新とメンテナンス
• ドキュメント
• このプロジェクトでの AI の活用
• ライセンス

概要

build82 を Moodle のインストール環境に接続すると、コードベース（version.php、db/*.php、XMLDB スキーマ、PHPDoc、フック、タスク、ケイパビリティ、ウェブサービスなど）をスキャンし、インストール環境と開発中のプラグインについて説明する Markdown コンテキストファイルを生成します。接続した AI アシスタントは、コードベースに関する質問に回答したり、既存の規約に沿って一貫性のある新しいプラグインをひな形から作成したり、作業中にドキュメントを同期したりできます。

主な機能：

• インストール環境の13 個のグローバルインデックス — API インデックス、DB テーブル、イベント、タスク、ケイパビリティ、クラス、ウェブサービス、プラグインインデックスなど。
• プラグインごとの12 個のコンテキストファイル — アーキテクチャ、依存関係、実行時のフロー、設定、AI ですぐに利用できる要約。
• 13 個の MCP ツール、3 個の MCP プロンプト、MCP リソース — コンテキストの生成、API とプラグインの検索、プラグインの説明、環境の診断（doctor）、リリース用のプラグインのパッケージ化、新しいプラグインのひな形の作成。
• ファイル監視機能により、ソースに変更があるたびに開発中のプラグインのコンテキストを再生成します。
• 2 種類の PHP 抽出バックエンド — 高速な正規表現（デフォルト）または pure-Go の tree-sitter。
• 出力を整理 — すべてのファイルは .build82/ 以下（Moodle のルートおよび各プラグインのルート）に書き込まれ、Moodle やプラグインのルートに直接散らばりません。
• 8 個の MCP クライアントへのネイティブなクライアント登録と、チェックサム検証およびロールバック機能を備えたセルフアップデート。

前提条件と簡単なインストール

前提条件：

• ローカルの Moodle インストール（build82 はそのソースツリーを読み取ります）。
• MCP クライアント — クライアントのセットアップを参照してください。
• 任意：エディターでのナビゲーション用に .build82/tags ファイルも生成する場合は、PATH 上に universal-ctags を用意してください。
• ソースからビルドする場合のみ：Go 1.26 以降。

リリースバイナリをダウンロードする（Go ツールチェーンは不要です）。すべてのリリースには checksums.txt が含まれています — ダウンロードしたバイナリを信頼する前に、必ず検証してください。v1.1.0 以降では、checksums.txt も Sigstore で署名され、すべてのバイナリに GitHub のビルド来歴アテステーションが付属します （検証方法）。 チェックサムの検証とトラブルシューティングを含む、手順を詳しく説明したガイドはこちらです： インストールガイド。

# amd64
curl -LO https://github.com/oito2/mcp-build82/releases/latest/download/build82_linux_amd64
curl -LO https://github.com/oito2/mcp-build82/releases/latest/download/checksums.txt
sha256sum -c checksums.txt --ignore-missing \
  && chmod +x build82_linux_amd64 \
  && sudo mv build82_linux_amd64 /usr/local/bin/build82

# arm64
curl -LO https://github.com/oito2/mcp-build82/releases/latest/download/build82_linux_arm64
curl -LO https://github.com/oito2/mcp-build82/releases/latest/download/checksums.txt
sha256sum -c checksums.txt --ignore-missing \
  && chmod +x build82_linux_arm64 \
  && sudo mv build82_linux_arm64 /usr/local/bin/build82

build82 --version

# Apple Silicon (M1/M2/M3/M4)
curl -LO https://github.com/oito2/mcp-build82/releases/latest/download/build82_darwin_arm64
curl -LO https://github.com/oito2/mcp-build82/releases/latest/download/checksums.txt
shasum -a 256 -c checksums.txt --ignore-missing \
  && chmod +x build82_darwin_arm64 \
  && sudo mv build82_darwin_arm64 /usr/local/bin/build82

# Intel
curl -LO https://github.com/oito2/mcp-build82/releases/latest/download/build82_darwin_amd64
curl -LO https://github.com/oito2/mcp-build82/releases/latest/download/checksums.txt
shasum -a 256 -c checksums.txt --ignore-missing \
  && chmod +x build82_darwin_amd64 \
  && sudo mv build82_darwin_amd64 /usr/local/bin/build82

Invoke-WebRequest -Uri "https://github.com/oito2/mcp-build82/releases/latest/download/build82_windows_amd64.exe" -OutFile "build82_windows_amd64.exe"
Invoke-WebRequest -Uri "https://github.com/oito2/mcp-build82/releases/latest/download/checksums.txt" -OutFile "checksums.txt"
Get-FileHash .\build82_windows_amd64.exe -Algorithm SHA256

Unblock-File .\build82_windows_amd64.exe
New-Item -ItemType Directory -Force -Path "$env:LOCALAPPDATA\build82"
Move-Item -Force .\build82_windows_amd64.exe "$env:LOCALAPPDATA\build82\build82.exe"
[Environment]::SetEnvironmentVariable("Path", "$env:Path;$env:LOCALAPPDATA\build82", "User")

または、ソースからビルドする（Go 1.26 以降が必要です）：

go install github.com/oito2/mcp-build82/cmd/build82@latest

クライアントのセットアップ

build82 を AI ツールの MCP サーバーとして登録します：

build82 install [target]

インストールされている対応ツールを検出し、Moodle のパスを尋ねます。対象を指定せずに実行すると、検出されたすべてのツールを設定します。対象を明示する場合は、claude（Claude Code）、claude-desktop、antigravity、codex、opencode、cursor、zed、cline を指定してください。最初にクライアントを終了してください。install は、クライアントも書き込む設定ファイルを編集します。

たとえば、Claude Code では手動で登録することもできます：

claude mcp add --scope user build82 -e BUILD82_MOODLE_PATH=/path/to/moodle -- /usr/local/bin/build82

Claude Desktop では、build82 をデスクトップ拡張機能としてインストールすることもできます。すべてのリリースにはバイナリを含む build82.mcpb バンドルが付属しています — Claude Desktopを参照してください。build82 は、公式 MCP Registry に io.github.oito2/mcp-build82 としても登録されています。

手動設定を含む、クライアントごとのガイドはこちらです：MCP クライアント。 削除するには、build82 uninstall [target] を実行してください — アンインストールを参照してください。

更新とメンテナンス

build82 self-update --check    # report whether a newer release exists (exit 10 if so), without installing it
build82 self-update            # download, verify, and install the latest release
build82 self-update --require-signature # refuse to update unless cosign can verify the release signature
build82 self-update --rollback # restore the previous binary if the new version turns out to be broken

ダウンロード元は、このリポジトリの GitHub 上のリリースのみです。PATH 上に cosign v3 以降がある場合は、先にリリースの署名を検証します。ない場合は警告を表示し、チェックサムのみを確認します。すべてのダウンロードはリリースの checksums.txt と照合してチェックサムを検証し、スモークテストに合格した後で、実行中のバイナリを置き換えます。以前のバイナリは <path>.bak として保持され、--rollback を実行すると両者が入れ替わります（そのため、もう一度実行すると元に戻ります）。バックアップが存在しない場合、またはバックアップが実行できない場合は、明確なエラーを表示して処理に失敗し、何も変更しません。詳しくはCLI リファレンスを参照してください。

ドキュメント

ドキュメントサイトの全内容は docs/en/index.md（ ポルトガル語版もあります）をご覧ください。主な入口は次のとおりです。

• クイックスタート — 数分で初回実行
• アーキテクチャ — build82 の仕組み、データフロー、設計上の判断
• ツール、リソース、プロンプトのリファレンス — MCP の各機能を詳しく解説
• CLIと設定のリファレンス — すべてのフラグ、環境変数、設定キー
• プロンプトの例 — AI エージェントへの質問例
• ガイドとトラブルシューティング

貢献する場合は、開発ワークフローとリリースプロセスについて CONTRIBUTING.md を、行動規範をご覧ください。

このプロジェクトにおける AI の利用

このプロジェクトは、生成 AI ツールの支援を受けて開発されました。

• 対象範囲： 定型コードの生成、単体テスト、ヘルパー関数のリファクタリング。

• 監督： 生成されたコードはすべて、統合前に手動でレビュー、テスト、検証しました。

ライセンス

GPL-3.0 — LICENSEをご覧ください。