minecode-mcp 0.1.2

MCP Server for Minecraft datapack development with wiki, Spyglass, Misode, and Mojira integrations

🎮 MineCode

MCP Server for Minecraft Datapack Development

MineCode is a Model Context Protocol (MCP) server that gives AI assistants like GitHub Copilot and Claude real-time access to Minecraft data, documentation, and datapack generators.

✨ Features

• 🔧 27 MCP Tools for Minecraft development
• 📚 Minecraft Wiki integration (search, pages, categories)
• 🐛 Mojira bug tracker search
• 🔍 Spyglass API (registries, commands, block states)
• 🎨 Misode Generators (loot tables, recipes, worldgen presets)

---

🚀 Installation

pip install minecode-mcp

---

⚙️ Configuration

VS Code (GitHub Copilot)

Add to User Settings (Ctrl+Shift+P → "MCP: Open User Configuration"):

{
	"servers": {
		"minecode": {
			"type": "stdio",
			"command": "py",
			"args": [
				"-m",
				"minecode.server"
			]
		}
	},
	"inputs": []
}

Or create .vscode/mcp.json in your workspace:

{
	"servers": {
		"minecode": {
			"type": "stdio",
			"command": "py",
			"args": [
				"-m",
				"minecode.server"
			]
		}
	},
	"inputs": []
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "minecode": {
      "command": "minecode"
    }
  }
}

OS	Config Path
Windows	%APPDATA%\Claude\claude_desktop_config.json
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

---

🛠️ Available Tools

Minecraft Wiki

Tool	Description
search_wiki	Search for wiki pages
get_wiki_page	Get page content and summary
get_wiki_commands	List all Minecraft commands
get_wiki_category	Get pages in a category
get_wiki_page_content	Get full page content for a wiki page
get_wiki_command_info	Get detailed command documentation from the wiki
get_wiki_random	Get random wiki pages

Mojira Bug Tracker

Tool	Description
search_mojira	Search bug reports

Spyglass API

Tool	Description
spyglass_get_versions	Get all MC versions with pack formats
spyglass_get_registries	Get registry entries (items, blocks, entities)
spyglass_get_block_states	Get block state properties
spyglass_get_commands	Get command syntax trees
spyglass_get_items	Get list of items for a version
spyglass_search_registry	Search a Spyglass registry for a query
spyglass_get_mcdoc_symbols	Get vanilla mcdoc symbols from Spyglass

Misode Generators

Tool	Description
misode_get_generators	List all datapack generators
misode_get_presets	Get vanilla presets for a generator
misode_get_preset_data	Get full JSON for a preset
misode_get_loot_tables	Get loot tables by category
misode_get_recipes	Get recipes with filtering
misode_list_versions	List available Misode/Minecraft versions
misode_get_data	Get raw Misode data for a version and data type
misode_search_data	Search Misode data for a query

Utility

Tool	Description
hello_world	Test connectivity
get_minecraft_version	Get version info
validate_datapack	Validate datapack structure
list_commands	List commands for a version

---

💡 Example Prompts

"Create a custom dimension with floating islands"

"What are the block states for a redstone repeater?"

"Show me the loot table for a desert temple chest"

"Search Mojira for elytra bugs"

"What's the syntax for the /execute command?"

---

📁 Project Structure

minecode-mcp/
├── minecode/
│   ├── __init__.py
│   ├── server.py          # MCP server with 27 tools
│   └── scrappers/
│       ├── minecraftwiki.py
│       ├── mojira.py
│       ├── spyglass.py
│       └── misode.py
├── example/
│   └── crystal_dimension/ # Example datapack
├── pyproject.toml
├── LICENSE
└── readme.md

---

🌐 Data Sources

Source	Description
Minecraft Wiki	Game documentation
Mojira	Bug tracker
Spyglass MC	Registries & commands
Misode	Vanilla presets

---

📄 License

MIT License - see LICENSE

---

Made with 💜 for the Minecraft community