minecraft-mod-mcp
Runs Gradle tasks via a project's Gradle wrapper to build Minecraft mods/plugins, with configurable task arguments, timeout, and output truncation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@minecraft-mod-mcp Scaffold a Paper 1.21.8 plugin called MyPlugin in ./my-plugin"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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'工具
工具 | 说明 | 参数 |
| 从模板生成完整工程 |
|
| 用 wrapper 跑 Gradle 任务,输出截断 |
|
| 平台 × 版本矩阵 | 无 |
| 读技能正文 |
|
| 读技能下的 API 参考 |
|
另暴露 8 份 skill://minecraft-xxx 资源。
技能
技能 | 说明 |
| 各时代 JDK / Gradle 配对与构建排错 |
| Paper / Spigot 1.20.x、1.21.x、26.x |
| Fabric |
| Forge 1.7.10 / 1.12.2 / 1.16.5 / 1.20.1 |
| NeoForge 1.20.1 / 1.21.x / 26.x |
| Spigot 1.7.10 / 1.12.2 |
| 老线主流模组附属开发 |
| 需求澄清问题矩阵 |
版本矩阵
平台 | 版本 | 默认 JDK |
Paper | 1.20.6、1.21.8、26.2、26.3 | 17 / 21 / 25 / 25 |
Fabric | 1.20.1、1.21.11、26.2、26.3 | 17 / 21 / 25 / 25 |
Forge | 1.7.10、1.12.2、1.16.5、1.20.1 | 8 / 8 / 8 / 17 |
NeoForge | 1.20.1、1.21.1、1.21.11、26.2、26.3 | 17 / 21 / 21 / 25 / 25 |
Spigot | 1.7.10、1.12.2 | 8 / 8 |
模板 13 套,位于 assets/templates/。
使用
mc_list_versions确认版本与 JDKmc_scaffold生成工程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)),原样保留;其中所述仲裁架构不在本仓库内。
Available Tools
5 toolsmc_gradleA
Run a Gradle task in a Minecraft project via its wrapper (gradlew). Reports exit code in result instead of failing on non-zero exits. Use to build, test, or run client/server tasks.
Inputs: task (required), projectDir (required), args, tailChars, +1 more.
mc_list_versionsA
List all supported platform × Minecraft version combinations with default Java levels.
Inputs: no named parameters.
mc_read_referenceA
Read an API reference file within a skill. Use mc_read_skill first to see available reference files.
Inputs: path (required).
mc_read_skillB
Read a Minecraft development skill document. Returns the full skill content for the specified skill name.
Inputs: skill (required).
mc_scaffoldA
Create a new Minecraft project from bundled template. Generates complete Gradle project: build scripts, main class, plugin/mod metadata, and Gradle wrapper. Supported platforms: paper, fabric, forge, neoforge, spigot.
Inputs: name (required), platform (required), targetDir (required), packageName (required), +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
The tools mostly have distinct purposes: scaffolding, running Gradle, listing versions, and reading skill/reference docs. mc_read_skill and mc_read_reference overlap conceptually, but the description establishes a clear hierarchy (skill first, then reference).
All tools use a consistent mc_ prefix and snake_case naming. The only minor deviation is mc_gradle, which names the tool after the underlying system rather than a verb_object pattern, but it remains readable and predictable.
Five tools is well-scoped for a Minecraft mod development helper. Each tool covers a distinct part of the workflow: documentation, project setup, builds, and version discovery.
Core workflows are covered: scaffold a project, run Gradle tasks, read skill docs/references, and list versions. However, there is no tool to list available skills, so mc_read_skill requires guessing a skill name, and no tool exists to inspect or edit existing project files, creating notable dead ends.
Maintenance
Related MCP Connectors
Official Duck Framework MCP server for AI-assisted development and project scaffolding.
Create guides as MCP servers to instruct coding agents to use your software (library, API, etc).
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
A MCP server built for developers enabling Git based project management with project and personal…
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides comprehensive access to MCP documentation through structured guides, full-text search, and interactive development workflows for building servers and clients.347 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables document retrieval, code generation, and code review for Minecraft China (NetEase) ModSDK development. It automates the creation of Mod projects, JSON configurations, and Python scripts while ensuring compliance with official development standards.100GPL 3.0
- FlicenseAqualityCmaintenanceProvides grounded answers for writing Minecraft mods, targeting 1.8.9 and 1.21.10+ eras with curated and live tools for mappings, APIs, and mixins.162-
- FlicenseBqualityDmaintenanceProvides API documentation browsing, code generation, and code review for Minecraft 1.21.1 Forge and NeoForge modding.201-