Minecraft Wiki MCP Server

Project Overview

A MCP-based Minecraft Wiki server that provides convenient access to Chinese Minecraft Wiki content. Supports stdio, SSE and http transports in a single package, and can be deployed quickly via uvx.

Note: This project only provides the MCP layer on top of a Minecraft wiki API. For local API deployment, please visit minecraft-wiki-fetch-api.

Features

• 🔍 Wiki Search: Search Chinese Minecraft Wiki pages with concise keyword guidance

• 📄 Page Retrieval: Get full page content in wikitext (default, token-efficient) or html

• ✅ Page Existence Check: Quick check if a page exists (including redirects)

• 📚 Namespace Listing: List available wiki namespaces for targeted search

• 🏥 Health Monitoring: Monitor backend Wiki API service status

• 🔌 Multi Transport: stdio (Claude Desktop / local clients), http (remote/server), sse (legacy)

• 🚀 One-Click Deployment: Run via uvx without local install

• ⚙️ Env + CLI Config: Flexible configuration via environment variables and CLI flags

Related MCP server: mcp-mediawiki-crunchtools

Quick Start

🚀 Recommended: Using uvx

# stdio (default) — for Claude Desktop / local MCP clients
uvx mc-wiki-fetch-mcp

# http — for remote / server deployment
uvx mc-wiki-fetch-mcp --transport http --host 0.0.0.0 --port 3001

# Custom Wiki API URL
uvx mc-wiki-fetch-mcp --api-url http://localhost:3000

# Or via environment variables
MC_WIKI_API_BASE_URL=http://localhost:3000 \
MC_WIKI_MCP_TRANSPORT=http \
uvx mc-wiki-fetch-mcp

# Help
uvx mc-wiki-fetch-mcp --help

💻 Integration with Claude Desktop (stdio)

1. Config file locations:

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Linux: ~/.config/claude/claude_desktop_config.json

2. Edit configuration:

   {
     "mcpServers": {
       "minecraft-wiki": {
         "command": "uvx",
         "args": ["mc-wiki-fetch-mcp"],
         "env": {
           "MC_WIKI_API_BASE_URL": "https://mcwiki.rice-awa.top"
         }
       }
     }
   }

3. Restart Claude Desktop

🌐 Remote / HTTP clients (http)

uvx mc-wiki-fetch-mcp -t http --host 0.0.0.0 --port 3001

Point your MCP client to the Streamable HTTP endpoint (must include /mcp):

http://<host>:3001/mcp

Example client config:

{
  "mcpServers": {
    "minecraft-wiki": {
      "url": "http://127.0.0.1:3001/mcp"
    }
  }
}

Note: The endpoint is /mcp, not the root /. Connecting to http://host:3001 will cause list_tools / tools/list to return 404. Use transport type http / streamable-http, not SSE.

Configuration Options

Environment Variables

Command Line Arguments

Priority: CLI args > environment variables > defaults.

Available Tools

Tips for Agents

• Prefer 1–3 game terms in search_wiki; extra keywords narrow results.

• Prefer wikitext for get_page (default). Use html only when a template is unreadable.

• Unknown {{Template}} in wikitext → call search_wiki with namespaces=[10].

Traditional Installation (Developers)

git clone <repository-url>
cd mc-wiki-mcp-pypi

pip install -e .
# or: uv pip install -e .

# stdio
mc-wiki-fetch-mcp

# http
mc-wiki-fetch-mcp -t http -p 3001

Troubleshooting

uvx not found

curl -LsSf https://astral.sh/uv/install.sh | sh
# or
pip install uv

Cannot connect to Wiki API

echo $MC_WIKI_API_BASE_URL
curl http://your-api-url/health
MC_WIKI_LOG_LEVEL=DEBUG uvx mc-wiki-fetch-mcp

Tools not visible in Claude Desktop

1. Confirm uvx mc-wiki-fetch-mcp --version works

2. Check Claude Desktop logs

3. Restart Claude Desktop

HTTP client returns 404 on list_tools

1. Confirm the client URL is http://<host>:<port>/mcp (the trailing /mcp is required)

2. Use transport http / streamable-http, not SSE

3. After restarting the server, reconnect the client so it gets a fresh session

Related Documentation

• API Documentation — Detailed API interface documentation

• Modification Summary — Recent packaging changes

Contributing

Issues and Pull Requests are welcome!

License

MIT License — see LICENSE.

Getting Help

1. Check the troubleshooting section above

2. Browse docs/

3. Open an Issue with logs

Quick tips

• 🚀 Local client: uvx mc-wiki-fetch-mcp (stdio)

• 🌐 Server mode: uvx mc-wiki-fetch-mcp -t http -p 3001

• ⚙️ Configure: env vars or CLI flags

• 🔧 Develop: pip install -e .