mcmodding

Provides up-to-date Minecraft modding docs and working code examples for Fabric and NeoForge via a searchable MCP server.

typescript

1

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ogmatrix-mcmodding-mcp": {
      "command": "mcmodding-mcp",
      "args": []
    }
  }
}

mcmodding-mcp is a server that powers AI assistants with current Minecraft modding documentation for Fabric and NeoForge. It keeps documentation fresh, provides accurate code examples, and enables semantic search so you can quickly find what you need without guessing from out-of-date sources.

How to use

You connect your MCP client to the mcmodding-mcp server to access up-to-date modding documentation and working code examples. Use the server to search for topics, retrieve practical code patterns, and explain modding concepts with references to real docs.

How to install

Prerequisites: you need a system with Node.js/npm available. If you don’t have Node installed, install it from nodejs.org before continuing.

Install the MCP server globally using npm.

npm install -g mcmodding-mcp

Configure your MCP client

Add the MCP server configuration to your AI client settings so it can route queries to mcmodding-mcp.

{
  "mcpServers": {
    "mcmodding": {
      "command": "mcmodding-mcp"
    }
  }
}

Additional configuration notes

The system prompt is optimized for best results. It instructs the AI to always use the mcmodding-mcp search and example retrieval tools for the latest modding docs and patterns.

Configuration and maintenance notes

The server updates its documentation index automatically on startup. It checks for new versions, downloads updates with verification, and creates backups before applying changes. The server starts immediately without blocking on updates.

Troubleshooting

If you encounter issues, verify Node.js is installed, the mcmodding-mcp package is installed globally, and your MCP client is configured to point at the mcmodding server. Check that the server starts without errors and that the client can reach the command mcmodding-mcp from your system PATH.

Examples of what you can ask

How do I register a custom item in Fabric? - Show me a pattern for creating and registering a block with a block entity in NeoForge.

Available tools

search_fabric_docs

Search documentation with smart filtering, returning relevant pages and sections for Fabric and NeoForge modding topics.

get_example

Retrieve working code examples for a given modding topic, language, and loader, so you can copy and adapt it.

explain_fabric_concept

Provide detailed explanations of modding concepts with links to related resources and examples.

get_minecraft_version

Query the current or all indexed Minecraft versions to ensure documentation matches the specified version.