MCDK-ASSISTANT

MCDK-ASSISTANT 是面向 NetEase Minecraft / Bedrock 开发场景的通用 MCP Server，用于把资料检索、原版资源搜索、参考速查、JSON UI 分析、NBT / 模型 / 动画等能力提供给 AI Agent。

它不替代编辑器或 Agent 本身，而是作为 Minecraft 工程语境下的能力层：让 Agent 在“查资料、理解结构、定位文件、生成修改、回读验证”的流程中少猜测、多验证。

项目仓库

更完整的编译、发布与工具说明请查看 MCDK-ASSISTANT。

能力概览

能力	说明
智能文档检索	查询知识库、网易教程、ModAPI、QuMod、Bedrock Wiki、BedrockDev 等资料
原版资源搜索	按文件名或内容定位行为包 / 资源包原版资产
参考速查	获取网易版差异、JSON UI、动画、模型等参考说明
JSON UI 分析	分析控件结构、属性与常见问题；写入类能力仅建议在完整版中按需开启
解决方案层	检索时浮现可运行范式与踩坑提示，减少只查到接口后盲猜组合方式的问题
插件系统	支持注册自定义 MCP Tool，也可接入自己的资料库作为扩展搜索源

版本选择

版本	可执行文件	建议用途
LITE 版	mcdk-asst-lite	默认推荐。聚焦资料检索、原版资源搜索和参考速查，不包含本地文件修改能力
完整版	mcdk-assistant	需要 JSON UI、NBT、模型、动画、像素画等本地资源读写能力时再启用
Server 版	mcdk-asst-server	在 LITE 能力基础上提供后台请求记录与统计接口，适合服务化部署

本地开发通常优先启用 mcdk-asst-lite。同一个 AI 客户端中一般只启用 LITE 版或完整版中的一个，避免重复暴露同类工具。

推荐接入

stdio 模式

stdio 模式无需额外部署服务，AI 客户端直接启动 MCP 进程。LITE 版和完整版都支持 --stdio 参数。

Codex 可在用户目录的 config.toml 中追加：

[mcp_servers.mcdk-asst-lite]
command = "D:/path/to/mcdk-asst-lite.exe"
args = ["--stdio"]
enabled = true
startup_timeout_sec = 30
tool_timeout_sec = 120

如果确认需要本地资源读写能力，可改用完整版：

[mcp_servers.mcdk-assistant]
command = "D:/path/to/mcdk-assistant.exe"
args = ["--stdio"]
enabled = true
startup_timeout_sec = 30
tool_timeout_sec = 120

能力边界

完整版包含本地资源读写与编辑能力，适合明确需要修改 JSON UI、NBT、模型、动画或像素画等资源时使用。只做资料检索和参考查询时，优先使用 LITE 版。

HTTP / SSE 模式

不带 --stdio 启动时，程序默认以 HTTP 模式运行，默认端口为 18766：

http://127.0.0.1:18766/sse

支持 SSE 的客户端可直接连接该地址。需要通过 mcp-remote 桥接的客户端则依赖本地 Node.js 环境。

验证连接

连接成功后，可以让 AI 客户端尝试：

• 搜索 minecraft:food 组件用法
• 搜索网易版和国际版 JSON UI 的主要差异
• 查找某个原版资源文件或动画资源

如果能返回对应资料、资源路径或参考说明，说明 MCP Server 已连接成功。

工具分层

新版 MCDK-ASSISTANT 倾向于使用“能力族入口 + command 子命令”的方式暴露 MCP Tool。细粒度教程、参数说明和速查内容通常通过 help 或 /help 延迟展开，以减少 tools/list 阶段长期占用上下文。

不熟悉某个能力入口时，优先请求对应入口的帮助说明，例如：

minecraft_docs(command="/help")
minecraft_ui(command="/help")
minecraft_model(command="/help")
minecraft_animation(command="/help")
minecraft_nbt(command="/help")

插件扩展

MCDK-ASSISTANT 也支持通过 Python 插件注册自定义 Tool，例如把团队内部文档、项目笔记或私有 SDK 说明接入为可检索资料库。其脚本引擎后端使用 PocketPy 而不是 CPython，具体写法见 插件与资料扩展。