Bedrock Wiki MCP

Ein selbst gehosteter, schreibgeschützter Model Context Protocol-Server für das Wissen über die Entwicklung von Add-ons für Minecraft Bedrock Edition.

Status

Meilenstein 0 – Repository/Bootstrap ist in Arbeit. Suche, Indizierung und Dokumentaufnahme sind absichtlich noch nicht implementiert.

Der geplante v1-Stack ist:

• Node.js 24 LTS

• TypeScript

• offizielles Model Context Protocol TypeScript SDK v2

• Streamable HTTP unter /mcp

• SQLite + FTS5 lexikalische Abfrage

• Bedrock-bewusstes Parsen, Chunking, exakte Identifikator-Übereinstimmung und versionsbewusstes Ranking

• keine kostenpflichtige API oder gehostete Vektordatenbank für den normalen Betrieb erforderlich

Related MCP server: repocks

Design-Einschränkungen

• Die öffentliche MCP-Funktionalität ist schreibgeschützt.

• Der MCP-Server wird Wissen bereitstellen, keinen beliebigen Dateisystemzugriff oder die Ausführung von Befehlen.

• Stabile Microsoft/Mojang-Dokumentation hat Priorität gegenüber Vorschau-, historischem oder Community-Material.

• Vorschau- und historisches API-Material wird in den Metadaten unterscheidbar sein und von der Standardabfrage ausgeschlossen, wenn eine aktuelle stabile Antwort existiert.

• Generierte Datenbanken und Quellcode-Auscheckungen sind Bereitstellungszustand und werden nicht in Git eingecheckt.

Geplante Wissensquellen

1. MicrosoftDocs/minecraft-creator – primäre Creator-Dokumentation und Script-API-Referenz.

2. Mojang/bedrock-samples main – offizielle stabile Verhaltens-/Ressourcenpaket-Beispiele.

3. Mojang/bedrock-samples preview – optionales Vorschaumaterial, standardmäßig deaktiviert.

4. microsoft/minecraft-samples – offizielle Tutorial- und Projektbeispiele.

Quelldefinitionen befinden sich in config/sources.json.

Entwicklung

Anforderungen:

• Node.js 24.x

• npm

Abhängigkeiten installieren:

npm install

Prüfungen ausführen:

npm run check

Entwicklungsserver starten:

npm run dev -- serve

Die sichere Standardbindung ist nur lokal:

http://127.0.0.1:8080/mcp

Gesundheitscheck:

GET http://127.0.0.1:8080/health

Umgebungsvariablen sind in .env.example dokumentiert.

Aktuelle CLI

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

Administrative Aufnahme-/Indexbefehle werden in späteren Meilensteinen hinzugefügt und nicht als öffentliche MCP-Tools bereitgestellt.

Repository-Datenrichtlinie

Die folgenden werden lokal generiert/bereitgestellt und von Git ignoriert:

• SQLite-Indizes

• SQLite-WAL/SHM-Dateien

• geklonte Upstream-Wissensquellen

• temporäre Aufnahmedateien

• Sicherungen

• Protokolle

knowledge/local/ ist für kuratiertes lokales Quellmaterial reserviert, das später bewusst zum Repository hinzugefügt wird.

Lizenz

Eine Projektlizenz wurde noch nicht ausgewählt.