Bedrock Wiki MCP

Сервер Model Context Protocol, разворачиваемый самостоятельно, с доступом только для чтения, для знаний по разработке аддонов для Minecraft Bedrock Edition.

Статус

Milestone 0 — создание репозитория/начальная загрузка в процессе. Поиск, индексация и импорт документов намеренно ещё не реализованы.

Запланированный стек v1:

• Node.js 24 LTS

• TypeScript

• официальный Model Context Protocol TypeScript SDK v2

• Streamable HTTP по адресу /mcp

• SQLite + FTS5 для лексического поиска

• парсинг с учётом Bedrock, разбиение на фрагменты, точное сопоставление идентификаторов и ранжирование с учётом версий

• для обычной работы не требуется ни платный API, ни размещённая векторная база данных

Related MCP server: repocks

Ограничения проектирования

• Публичная функциональность MCP доступна только для чтения.

• MCP-сервер будет предоставлять знания, а не произвольный доступ к файловой системе или выполнение команд.

• Стабильная документация Microsoft/Mojang имеет приоритет над предварительными, историческими или созданными сообществом материалами.

• Предварительные и исторические материалы API будут различимы в метаданных и исключены из выдачи по умолчанию, когда существует актуальный стабильный ответ.

• Сгенерированные базы данных и копии исходников являются состоянием развёртывания и не фиксируются в Git.

Планируемые источники знаний

1. MicrosoftDocs/minecraft-creator — основная документация Creator и справочник Script API.

2. Mojang/bedrock-samples main — официальные стабильные примеры пакетов поведения/ресурсов.

3. Mojang/bedrock-samples preview — дополнительный предварительный материал, отключён по умолчанию.

4. microsoft/minecraft-samples — официальные учебные и проектные примеры.

Определения источников находятся в config/sources.json.

Разработка

Требования:

• Node.js 24.x

• npm

Установка зависимостей:

npm install

Запуск проверок:

npm run check

Запуск сервера разработки:

npm run dev -- serve

Безопасная привязка по умолчанию — только локальный доступ:

http://127.0.0.1:8080/mcp

Проверка состояния:

GET http://127.0.0.1:8080/health

Переменные окружения описаны в .env.example.

Текущий CLI

bedrock-mcp serve
bedrock-mcp version
bedrock-mcp help

Административные команды импорта/индексации будут добавлены в последующих вехах и не будут предоставляться как публичные MCP-инструменты.

Политика данных репозитория

Следующее генерируется локально/при развёртывании и игнорируется Git:

• индексы SQLite

• файлы SQLite WAL/SHM

• клонированные вышестоящие источники знаний

• временные файлы импорта

• резервные копии

• логи

knowledge/local/ зарезервирован для курируемых локальных исходных материалов, которые будут намеренно добавлены в репозиторий позже.

Лицензия

Лицензия проекта ещё не выбрана.