Minecraft Wiki MCP

An MCP Server for browsing the official Minecraft Wiki!

> [!WARNING]

> This is v2 — a complete Python rewrite. If you're upgrading from v1 (TypeScript), see the migration notes below.

> [!TIP]

> Public Hosted Instance: You can connect to the public hosted instance of this server directly at `https://minecraft-wiki-mcp.goett.top/mcp` without installing or running anything locally! See Streamable HTTP Transport below for instructions.

Features

• 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

Requirements

• Python 3.12+
• uv (recommended package manager)

Installation

Quick Start with uv

# 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

With pip

pip install -e .
minecraft-wiki-mcp

Configuration

Claude Desktop

Add to your `claude_desktop_config.json`:

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

Claude Code

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

Multi-Language Support

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"
      }
    }
  }
}

Streamable HTTP Transport

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

Connecting Major Platforms to the Public Instance

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.

Configuration

Configure host, port, and security via environment variables:

Available Tools

Search & Navigation

Categories

Recommended Workflow

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

Development

# 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

Acknowledgements

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!

Migrating from v1

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