Bedrock Wiki MCP

一个用于 Minecraft Bedrock Edition 附加包开发知识的自托管、只读 Model Context Protocol 服务器。

状态

里程碑 0 — 仓库/引导程序正在进行中。 搜索、索引和文档摄取尚未实现。

计划中的 v1 技术栈包括：

• Node.js 24 LTS

• TypeScript

• 官方 Model Context Protocol TypeScript SDK v2

• 位于 /mcp 的 Streamable HTTP

• 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/ 保留用于稍后有意添加到仓库的精选本地源材料。

许可证

尚未选择项目许可证。