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

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

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

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:

  Copy

  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: