Skip to main content
Glama
Minecraft Wiki MCP Server

Minecraft Wiki MCP Server

by rice-awa

Minecraft Wiki MCP Server

English 中文

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

# 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

Environment Variable

Description

Default

MC_WIKI_API_BASE_URL / API_BASE_URL

Wiki API base URL

https://mcwiki.rice-awa.top

MC_WIKI_API_TIMEOUT

API request timeout (seconds)

60

MC_WIKI_MCP_TRANSPORT

Transport: stdio / sse / http

stdio

MC_WIKI_MCP_HOST

Bind host (HTTP/SSE)

0.0.0.0

MC_WIKI_MCP_PORT

Bind port (HTTP/SSE)

3001

MC_WIKI_MCP_NAME

MCP server display name

Minecraft Wiki

MC_WIKI_LOG_LEVEL

Log level

INFO

Command Line Arguments

Parameter

Description

--transport, -t

stdio / sse / http

--host

Bind host for HTTP/SSE

--port, -p

Bind port for HTTP/SSE

--api-url

Wiki API base URL

--timeout

API request timeout (seconds)

--log-level

DEBUG / INFO / WARNING / ERROR / CRITICAL

--name

MCP server display name

--version

Show version

--help

Show help

Priority: CLI args > environment variables > defaults.

Available Tools

Tool

Description

Main Parameters

search_wiki

Search Chinese Minecraft Wiki

q, limit, namespaces

get_page

Get page content (wikitext/html)

pageName, format, useCache, includeMetadata

check_page_exists

Check whether a page exists

pageName

check_health

Check Wiki API health

—

list_namespaces

List wiki namespace ID → name map

—

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

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 .

Available Tools

5 tools
check_healthA

检查 Wiki API 服务健康状态。

Inputs: no named parameters. Returns: result

check_page_existsC

检查页面是否存在。

Inputs: pageName (required). Returns: result

get_pageA

获取 Minecraft 中文 Wiki 页面的内容。

根据页面名称获取 Wiki 页面的完整内容。

格式选择:

  • wikitext(默认):Wiki 原始标记语言,{{Template}} 完整保留,信息最全。

  • html:清洗后的正文 HTML。仅当 wikitext 中某个模板语法确实无法理解时才使用。

wikitext 中遇到不认识的 {{Template}} 时,可用 search_wiki 传 namespaces=[10] 去模板命名空间搜索该模板的文档。

Inputs: pageName (required), format, useCache, includeMetadata. Returns: result

list_namespacesA

获取 Minecraft Wiki 的命名空间映射表。

返回所有可用命名空间的数字 ID 和对应名称。 结合 search_wiki 的 namespaces 参数使用。

Inputs: no named parameters. Returns: result

search_wikiA

搜索 Minecraft 中文 Wiki。

用1-3个游戏名词查找匹配的页面。多关键词会缩小范围(所有词须同时出现在结果页面中), 如需多角度搜索应分批调用本工具,而非把大量关键词堆在一次查询中。

Inputs: q (required), limit, namespaces. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a distinct purpose: checking existence, searching, fetching page content, health check, and listing namespaces. No overlap in functionality.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., check_page_exists, search_wiki, get_page). No inconsistencies.

    Tool Count5/5

    With 5 tools, the server is well-scoped for read-only wiki operations: existence check, search, content retrieval, health, and namespace mapping. Appropriate for the domain.

    Completeness4/5

    Covers core read operations (search, get, check existence) and auxiliary (health, namespaces). Missing list_pages or revision retrieval, but not critical for basic wiki access.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers