Minecraft Modding Mcp

Name: Minecraft Modding Mcp
Author: OGMatrix

@OGMatrix

关于 Minecraft Modding Mcp

mcmodding-mcp is a Model Context Protocol (MCP) server that gives AI assistants like Claude direct access to Minecraft modding documentation. Instead of relying on potentially outdated training data, your AI assistant can search real documentation, find code examples, and explain

#mc #minecraft #mcp #mod #mods #modding #documentation

基本信息

分类

AI 与智能体

传输方式

stdio

发布者

OGMatrix

提交者

OGMatrix

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is mcmodding-mcp?

mcmodding-mcp is a Model Context Protocol (MCP) server that gives AI assistants direct access to up-to-date Minecraft modding documentation for Fabric and NeoForge. It enables AI tools to search real documentation, find code examples, and explain modding concepts without relying on outdated training data.

How to use mcmodding-mcp?

Install globally with npm install -g mcmodding-mcp, then add "command": "mcmodding-mcp" to your MCP client configuration (e.g., Claude Desktop). Optionally include the provided system prompt to instruct the AI to always use the server’s tools instead of internal knowledge.

Key features of mcmodding-mcp

Always current – documentation indexed weekly from official sources
Semantic search understands meaning, not just keywords
Hybrid search engine combining FTS5, embeddings, sections, and code search
Auto-updates with hash verification and backup creation
Zero configuration – works immediately after installation
Four tools: search, examples, concept explanations, version info

Use cases of mcmodding-mcp

AI assistant finds the latest Fabric/NeoForge documentation for any modding topic
Developer retrieves working code examples for custom blocks, items, or mixins
User gets detailed explanations of modding concepts with related resources
Project checks current Minecraft version or all indexed versions

FAQ from mcmodding-mcp

What documentation sources does mcmodding-mcp index?

It indexes the Fabric Wiki (wiki.fabricmc.net), Official Fabric Docs (docs.fabricmc.net), and NeoForge Docs (docs.neoforged.net), totaling over 1,000 pages.

How does the auto-update system work?

On startup, the server compares the local database version against GitHub releases. If a newer version exists, it downloads the update with hash verification, creates a backup, and applies the changes – all without blocking the server.

What runtime dependencies are required?

The server requires Node.js and is installed via npm. It uses local SQLite (better-sqlite3) and Transformers.js for embeddings, so no external services are needed.

Can I disable automatic updates?

Yes, set the DB_PATH environment variable to a custom database file path. The server will then skip auto-updates for that file.

How do the search tools work?

The server provides four tools: search_fabric_docs (with filters for category, loader, version), get_example (code examples by topic), explain_fabric_concept (detailed explanations), and get_minecraft_version (version info). They run over stdio transport.