https://github.com/embeddedt/mcdev-mcp
Local MCP server to assist coding agents with Minecraft mod development
https://github.com/embeddedt/mcdev-mcp
Last synced: 11 days ago
JSON representation
Local MCP server to assist coding agents with Minecraft mod development
- Host: GitHub
- URL: https://github.com/embeddedt/mcdev-mcp
- Owner: embeddedt
- License: osl-3.0
- Created: 2026-05-27T01:40:29.000Z (24 days ago)
- Default Branch: main
- Last Pushed: 2026-05-27T01:45:12.000Z (24 days ago)
- Last Synced: 2026-05-27T03:20:47.561Z (24 days ago)
- Language: Java
- Size: 33.2 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# mcdev-mcp
A purpose-built Model Context Protocol (MCP) server for Minecraft mod development.
## Frequently Asked Questions
See [FAQ.md](FAQ.md).
## Setup
1. Build the JAR: `./gradlew shadowJar`, produces `build/libs/mcdev-mcp.jar` as output
2. Add it as a local MCP server to your favorite agentic harness using a command like
`java -Xms16M -Xmx512M -jar `.
3. If your harness has a permissions system, whitelist reading from `/tmp/mcdev-mcp` folder and all tools from mcdev-mcp to
avoid nuisance permission prompts. For Claude Code, this can be done with a block like the following in `~/.claude/settings.json`:
```json
"permissions": {
"allow": [
"Read(//tmp/mcdev-mcp/**)",
"mcp__mcdev-mcp"
]
}
```
## System requirements
The MCP server assumes that `java` is available on the PATH and can be used to run other subprocesses like the decompiler.
## Credits
`mcdev-mcp` uses code from or otherwise directly depends on several other projects:
- [NeoFormRuntime](https://github.com/neoforged/NeoFormRuntime/) for obtaining source code of modern Minecraft versions (>=1.17)
- [ZSON](https://github.com/Nolij/ZSON) for JSON parsing and serialization
## License
`mcdev-mcp` is distributed under the OSL-3.0 license.