L3 N0X Minecraft Wiki MCP

An MCP Server for browsing the official Minecraft Wiki!

• Wiki Search — Find information about Minecraft structures, entities, items, and blocks
• Page Summaries — Get a page's intro plus a table of contents to navigate further
• Section Access — Read specific sections as raw wikitext
• Full Page Content — Retrieve the entire page when you need everything
• Category Browsing — Explore wiki categories and their member pages
• Redirect Resolution — Follow redirects to find the canonical page
• Multi-Language Support — Connect to any language version of the Minecraft Wiki

• Python 3.12+
• uv (recommended package manager)

# Clone the repository
git clone https://github.com/L3-N0X/Minecraft-Wiki-MCP.git
cd Minecraft-Wiki-MCP

# Install dependencies
uv sync

# Run the server
uv run minecraft-wiki-mcp

pip install -e .
minecraft-wiki-mcp

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "minecraft-wiki": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/Minecraft-Wiki-MCP",
        "run", "minecraft-wiki-mcp"
      ]
    }
  }
}

claude mcp add minecraft-wiki -- uv --directory /path/to/Minecraft-Wiki-MCP run minecraft-wiki-mcp

By default, the server connects to the English wiki (https://minecraft.wiki/api.php). Set the MINECRAFT_WIKI_API_URL environment variable to use a different language:

{
  "mcpServers": {
    "minecraft-wiki": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/Minecraft-Wiki-MCP",
        "run", "minecraft-wiki-mcp"
      ],
      "env": {
        "MINECRAFT_WIKI_API_URL": "https://de.minecraft.wiki/api.php"
      }
    }
  }
}

By default, the server uses stdio transport (communication via stdin/stdout). For remote or multi-client access, you can use Streamable HTTP transport:

# Start the HTTP server (default: http://127.0.0.1:8000/mcp)
uv run minecraft-wiki-mcp --transport streamable-http

Then connect clients to the HTTP endpoint. For example, to connect to the public hosted instance using Claude Code:

claude mcp add --transport http minecraft-wiki https://minecraft-wiki-mcp.goett.top/mcp

Or for a local server:

claude mcp add --transport http minecraft-wiki http://localhost:8000/mcp

The public hosted URL https://minecraft-wiki-mcp.goett.top/mcp can be easily added across major platforms that support remote MCP connections or custom apps:

• Claude Code:

  claude mcp add --transport http minecraft-wiki https://minecraft-wiki-mcp.goett.top/mcp

• Claude (Web & Desktop) & Perplexity:

  1. Open your settings/customization page (e.g., Customize -> Connectors in Claude).
  2. Select the option to add a remote server using the HTTP/SSE transport.
  3. Enter https://minecraft-wiki-mcp.goett.top/mcp as the server URL.

• ChatGPT Website (Custom Apps): ChatGPT supports connecting custom MCP servers natively (even on the free tier) when developer mode is enabled:

  1. Open ChatGPT Settings -> Apps -> Advanced Settings and enable Developer Mode.
  2. Go back and create a new app.
  3. Enter https://minecraft-wiki-mcp.goett.top/mcp as the MCP server URL to connect.

Configure host, port, and security via environment variables:

For best results, LLMs should follow this pattern:

1. Search — minecraft_wiki_search to find the right page
2. Summarize — minecraft_wiki_get_page to see the intro and available sections
3. Deep dive — minecraft_wiki_get_section to read specific sections

# Install dependencies
uv sync

# Run with the MCP Inspector for interactive testing
uv run mcp dev src/minecraft_wiki_mcp/server.py

# Syntax check
uv run python -m py_compile src/minecraft_wiki_mcp/server.py

A special thank you to stone-brick for developing the fantastic minecraft-wiki-MDifier library! This library converts complex Minecraft wikitext into clean, easy-to-read Markdown, which not only improves the parsing results of the MCP server but also significantly saves token usage for LLMs. Thank you for the help and for building this great library!

v2 is a complete rewrite from TypeScript to Python. Key changes:

Other breaking changes:

• Configuration via MINECRAFT_WIKI_API_URL env var instead of --api-url CLI flag
• Runtime: Python 3.12+ with uv instead of Node.js
• Content is raw wikitext instead of HTML-stripped text