为降低开发者使用 Mod SDK 的开发门槛
Mod SDK MCP Server 现已正式开源上线
开发者可通过此工具让 AI 编程助手直接理解 Mod SDK
实现文档检索、代码生成、代码审查一站式 AI 辅助开发
让 Mod 开发更高效、更规范、更轻松

功能介绍

一、基本介绍
·  MCP（Model Context Protocol）是一种让 AI 编程助手获取外部工具能力的标准协议。
·  Mod SDK MCP Server 为 AI 助手提供了中国版 Mod SDK 的完整知识库，让 AI 真正懂得 Mod SDK 开发。
·  MCP支持 Claude Desktop、Cursor、CodeMaker 等主流 AI 编程客户端。

二、核心能力一览
1、智能文档检索：模糊搜索、驼峰分词、中文搜索，覆盖全部 API 接口与事件文档，告别翻文档的烦恼；
2、一键代码生成：自动生成符合中国版规范的 Mod 项目模板、Server/Client System、自定义物品/方块/实体代码；
3、工具与武器生成：一键生成剑、镐、斧、锹、锄、弓、盔甲、食物、可投掷物品的完整 JSON 配置；
4、配方与战利品表：生成有序/无序合成配方、熔炉配方、战利品表、生成规则，无需手写繁琐 JSON；
5、代码审查：自动检测 Python 2.7 兼容性问题、客户端/服务端混用错误、性能反模式，把关代码质量；
6、组件百科查询：随时查询物品/方块/实体/中国版特有组件的用法和配置细节；
7、内置最佳实践：生成的所有代码自动遵循官方性能优化规范，CompFactory 缓存、Tick 降帧、点对点通信等规范开箱即用。

三、支持 Context7
除了自建 MCP Server，Mod SDK 技术文档已同步上线 Context7 平台，助力零配置获取最新文档。
Context7 是一个为 AI 编程助手提供实时、版本特定文档的 MCP 服务。
Mod SDK 文档已被完整收录，其中包含58万+ tokens，3800+ 文档片段在内，覆盖 Mod API、Apollo 等全部模块。
·  无需部署：不用克隆仓库、不用安装依赖，安装 Context7 MCP 即可使用
·  始终最新：文档随官方仓库自动同步更新，无需手动维护
·  使用极简：只需在提示词中加上 use context7，AI 助手将自动拉取最新 Mod SDK 文档。示例："帮我用 Server System 监听玩家攻击事件并扣除耐久 use context7"

以上两者方案可以同时使用、互为补充：用 Context7 快速查文档，用 MCP Server 生成代码和审查质量。

Context7 Mod SDK 文档地址：
https://context7.com/mcneteasedevs/mc-netease-sdk
Context7 安装指南：
https://github.com/upstash/context7#installation

四、适用AI客户端
·  Claude Desktop（推荐）
·  Cursor / VS Code
·  支持 SSE 协议的任意 MCP 客户端

使用方法

一、快速开始 Mod SDK MCP Server
·  前置要求：Python >=3.10，pip 包管理器
·  克隆仓库后安装依赖：pip install -r requirements.txt
·  在 AI 客户端中配置 MCP Server 连接信息后重启客户端使用
·  验证连接：在 AI 助手中输入"搜索 GetEngineCompFactory 的用法"，返回文档内容即表示成功

详细配置指南请参阅仓库 README：
https://github.com/MCNeteaseDevs/modsdk_mcp_server

二、使用示例
1、生成 Mod 项目：
"帮我创建一个名为'传送系统'的 Mod，ID 为 teleport_sys，功能是让玩家通过命令传送到指定位置"
2、生成自定义武器：
"帮我生成一把自定义钻石剑，命名空间 mymod，ID 为 diamond_blade，攻击力 10，耐久 500"
3、代码审查：
直接粘贴代码，AI 助手将自动检测不规范写法并给出修改建议。
4、查询组件用法：
  "搜索 minecraft:food 组件的详细用法"

三、内置代码规范
·  客户端/服务端严格分离，Server System 禁止 import clientApi
·  CompFactory 模块级缓存，避免重复创建
·  所有 import 必须在文件顶部
·  Tick 事件自动使用质数取模降帧
·  优先点对点通信，慎用全服广播
·  完全兼容 Python 2.7，禁止 f-string、type hints

Mod SDK MCP Server 与 Context7 现已就绪
开发者们快来体验 AI 驱动的 Mod 开发新方式
让 AI 成为你的 Mod SDK 开发搭档！
如果各位开发者有任何疑问或反馈
欢迎前往 GitHub 仓库 提交 Issue 和 Pull Request
一旦采纳，我们会送出精美礼品！
此外也可通过开发者平台 - 问题与反馈中心进行反馈
或通过官方社群与志愿者沟通
期待你用 AI 创造出更多精彩模组！
更多讯息请关注《我的世界》官网动态