minecraft-mod-mcp

Minecraft 模组 / 插件开发 MCP 服务器（stdio）。提供起工程、跑 Gradle、查开发知识三类工具，覆盖 MC 1.7.10 ~ 26.3 的 Paper / Fabric / Forge / NeoForge / Spigot。

安装

需要 Node.js ≥ 18。

git clone https://github.com/jingchenGOD/minecraft-mod-mcp.git
cd minecraft-mod-mcp
npm install

依赖：@modelcontextprotocol/sdk、zod。

Related MCP server: NetEase ModSDK MCP Server

配置

{
  "mcpServers": {
    "minecraft-dev": {
      "command": "node",
      "args": ["/绝对路径/minecraft-mod-mcp/index.js"]
    }
  }
}

DSH：

- insert:
    - id: mcp-mc-dev
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: 'minecraft-dev'
        transport: 'stdio'
        command: 'node'
        args:
          - '/绝对路径/minecraft-mod-mcp/index.js'

工具

另暴露 8 份 skill://minecraft-xxx 资源。

技能

版本矩阵

模板 13 套，位于 assets/templates/。

使用

1. mc_list_versions 确认版本与 JDK

2. mc_scaffold 生成工程

3. mc_gradle 跑 build

注意

• 首次构建需下载并 merge 整个 Minecraft 环境，耗时较长。

• mc_gradle 只保留输出前后共 12000 字符，完整日志见 projectDir/build/reports/。

• Forge 1.20.1 构建卡在 Gradle 下载时，把 gradle/wrapper/gradle-wrapper.properties 的 distributionUrl 换成 https://mirrors.cloud.tencent.com/gradle/gradle-8.1.1-bin.zip。

• Spigot 1.7.10 无公开 maven，构建前按 libs/README.txt 放入 API jar。

• targetDir 必须不存在或为空。

• 部分技能文档保留 DSH 专有提法（如 ask_user_question），在其他客户端按对应机制理解。

• 版本坐标核对于 2026-08-16，更新需改 lib/versions.js。

许可

MIT，完整文本见 LICENSE。包含上游 DSH 插件 minecraft-dev 的 MIT 版权声明。

本项目从该插件提取可移植部分重组，未包含其子代理、Agent 预设与 Codex 集成。

NOTICE.txt 来自上游 v0.12.0+（Apache-2.0 §4(d)），原样保留；其中所述仲裁架构不在本仓库内。