build82

build82

🌐 **语言：**英语 · 葡萄牙语

一个 MCP（模型上下文协议）服务，为 AI 助手提供对 Moodle 安装及其插件的结构化理解，使其能够回答有关代码库的问题，并构建符合其实际约定的插件。以单个静态二进制文件形式分发。

目录

• 概述
• 前置条件与快速安装
• 客户端设置
• 更新与维护
• 文档
• 本项目中的 AI 用法
• 许可证

概述

将 build82 指向 Moodle 安装目录，它就会扫描代码库（version.php、db/*.php、XMLDB 架构、PHPDoc、钩子、任务、功能权限、Web 服务等），并生成一组 Markdown 上下文文件，用来描述该安装以及你正在开发的任何插件。连接到它的 AI 助手可以回答有关代码库的问题，按照现有约定构建新插件，并在你工作时保持文档同步。

主要功能：

• 安装目录的 13 个全局索引——API 索引、数据库表、事件、任务、功能权限、类、Web 服务、插件索引等。
• 12 个插件级上下文文件——架构、依赖项、运行时流程、设置和适用于 AI 的摘要。
• 13 个 MCP 工具、3 个 MCP 提示词和 MCP 资源——生成上下文、搜索 API 和插件、说明插件、诊断环境（doctor）、打包插件以供发布，以及创建新的插件骨架。
• 文件监视器，在开发插件的源文件发生更改时重新生成其上下文。
• 两种 PHP 提取后端——快速正则表达式（默认）或纯 Go tree-sitter。
• 整洁的输出——所有内容都写入 .build82/ 下（位于 Moodle 根目录和各插件根目录），不会散落在 Moodle 或插件根目录中。
• 原生注册到 8 个 MCP 客户端，并支持经过校验和验证且可回滚的 自更新。

前置条件与快速安装

前置条件：

• 本地 Moodle 安装（build82 会读取其源代码树）。
• MCP 客户端 — 请参阅客户端设置。
• 可选：将 universal-ctags 添加到 PATH，以便同时生成 .build82/tags 文件，供编辑器导航使用。
• 仅在从源代码构建时需要：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

客户端设置

在你的 AI 工具中将 build82 注册为 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 中存在 v3 或更高版本的 cosign，会先验证发布版本的签名；如果没有，则会打印警告，并仅检查校验和。每次下载都会根据发布版本的 checksums.txt 验证校验和，并在替换正在运行的二进制文件前进行冒烟测试；之前的二进制文件会保留为 <path>.bak，而 --rollback 会交换这两个文件（因此再次运行即可撤销操作）。如果备份不存在或无法运行，程序会显示明确的错误，并且不会更改任何内容。详情： CLI 参考。

文档

完整的文档网站位于 docs/en/index.md（也提供葡萄牙语版）。主要入口：

• 快速入门 — 几分钟内完成首次运行
• 架构 — build82 的工作原理、数据流和设计决策
• 工具、资源和提示词参考 — 详细介绍每项 MCP 功能
• CLI和配置参考 — 介绍每个标志、环境变量和配置项
• 提示词示例 — 可以向 AI Agent 提出的问题
• 指南和故障排查

贡献：开发工作流和发布流程请参阅 CONTRIBUTING.md，另请参阅行为准则。

本项目中的 AI 使用情况

本项目在开发过程中借助了生成式 AI 工具：

• 范围： 生成样板代码、单元测试，并重构辅助函数。

• 监督： 所有生成的代码在集成前均经过人工审查、测试和验证。

许可证

GPL-3.0 — 请参阅 LICENSE。