Bedrock Wiki MCP

Un servidor del Model Context Protocol autoalojado y de solo lectura para el conocimiento sobre el desarrollo de complementos de Minecraft Bedrock Edition.

Estado

Hito 0 — repositorio/arranque en curso. La búsqueda, la indexación y la ingesta de documentos todavía no están implementadas a propósito.

El stack previsto para v1 es:

• Node.js 24 LTS

• TypeScript

• SDK oficial v2 de Model Context Protocol para TypeScript

• Streamable HTTP en /mcp

• SQLite + FTS5 para recuperación léxica

• análisis sintáctico específico de Bedrock, fragmentación, coincidencia exacta de identificadores y clasificación sensible a la versión

• sin API de pago ni base de datos vectorial alojada necesarias para el funcionamiento normal

Related MCP server: repocks

Restricciones de diseño

• La funcionalidad pública del MCP es de solo lectura.

• El servidor MCP expondrá conocimiento, no acceso arbitrario al sistema de archivos ni ejecución de comandos.

• La documentación estable de Microsoft/Mojang tiene prioridad sobre el material de vista previa, histórico o de la comunidad.

• El material de API de vista previa e histórico será distinguible en los metadatos y quedará excluido de la recuperación por defecto cuando exista una respuesta estable actual.

• Las bases de datos generadas y los clones de los repositorios de origen son estado de despliegue y no se incluyen en Git.

Fuentes de conocimiento planificadas

1. MicrosoftDocs/minecraft-creator — documentación principal de Creator y referencia de Script API.

2. Mojang/bedrock-samples main — muestras oficiales estables de paquetes de comportamiento/recursos.

3. Mojang/bedrock-samples preview — material oficial de vista previa, deshabilitado por defecto.

4. microsoft/minecraft-samples — muestras oficiales de tutoriales y proyectos.

Las definiciones de fuentes se encuentran en config/sources.json.

Desarrollo

Requisitos:

• Node.js 24.x

• npm

Instalar dependencias:

npm install

Ejecutar comprobaciones:

npm run check

Iniciar el servidor de desarrollo:

npm run dev -- serve

El enlace seguro por defecto es solo local:

http://127.0.0.1:8080/mcp

Comprobación de estado:

GET http://127.0.0.1:8080/health

Las variables de entorno están documentadas en .env.example.

CLI actual

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

Los comandos administrativos de ingesta/indexación se añadirán en hitos posteriores y no se expondrán como herramientas públicas de MCP.

Política de datos del repositorio

Los siguientes elementos se generan localmente o se despliegan, y Git los ignora:

• índices de SQLite

• archivos WAL/SHM de SQLite

• fuentes de conocimiento upstream clonadas

• archivos temporales de ingesta

• copias de seguridad

• registros

knowledge/local/ está reservado para material de fuentes locales curado que se añadirá deliberadamente al repositorio más adelante.

Licencia

Aún no se ha seleccionado una licencia para el proyecto.