Minecraft Wiki MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Minecraft Wiki MCP Server search wiki for 'redstone mechanics'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
uvxwithout 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)
Config file locations:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonLinux:
~/.config/claude/claude_desktop_config.json
Edit configuration:
{ "mcpServers": { "minecraft-wiki": { "command": "uvx", "args": ["mc-wiki-fetch-mcp"], "env": { "MC_WIKI_API_BASE_URL": "https://mcwiki.rice-awa.top" } } } }Restart Claude Desktop
🌐 Remote / HTTP clients (http)
uvx mc-wiki-fetch-mcp -t http --host 0.0.0.0 --port 3001Point your MCP client to the Streamable HTTP endpoint (must include /mcp):
http://<host>:3001/mcpExample client config:
{
"mcpServers": {
"minecraft-wiki": {
"url": "http://127.0.0.1:3001/mcp"
}
}
}Note: The endpoint is
/mcp, not the root/. Connecting tohttp://host:3001will causelist_tools/tools/listto return 404. Use transport type http / streamable-http, not SSE.
Configuration Options
Environment Variables
Environment Variable | Description | Default |
| Wiki API base URL |
|
| API request timeout (seconds) |
|
| Transport: |
|
| Bind host (HTTP/SSE) |
|
| Bind port (HTTP/SSE) |
|
| MCP server display name |
|
| Log level |
|
Command Line Arguments
Parameter | Description |
|
|
| Bind host for HTTP/SSE |
| Bind port for HTTP/SSE |
| Wiki API base URL |
| API request timeout (seconds) |
|
|
| MCP server display name |
| Show version |
| Show help |
Priority: CLI args > environment variables > defaults.
Available Tools
Tool | Description | Main Parameters |
| Search Chinese Minecraft Wiki |
|
| Get page content (wikitext/html) |
|
| Check whether a page exists |
|
| Check Wiki API health | — |
| 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). Usehtmlonly when a template is unreadable.Unknown
{{Template}}in wikitext → callsearch_wikiwithnamespaces=[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 3001Troubleshooting
uvx not found
curl -LsSf https://astral.sh/uv/install.sh | sh
# or
pip install uvCannot 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-mcpTools not visible in Claude Desktop
Confirm
uvx mc-wiki-fetch-mcp --versionworksCheck Claude Desktop logs
Restart Claude Desktop
HTTP client returns 404 on list_tools
Confirm the client URL is
http://<host>:<port>/mcp(the trailing/mcpis required)Use transport http / streamable-http, not SSE
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
Check the troubleshooting section above
Browse docs/
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 toolscheck_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
Scored across 5 tools
Each tool has a distinct purpose: checking existence, searching, fetching page content, health check, and listing namespaces. No overlap in functionality.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., check_page_exists, search_wiki, get_page). No inconsistencies.
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.
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
Related MCP Connectors
Unofficial Wikipedia MCP — wraps Wikipedia REST API (free, no auth)
Read-only MCP for the Eco game wiki: search, Markdown pages, and wiki_* lookups. No keys, no writes.
Read and write your team's shared, AI-readable wiki from any MCP client.
Web and URL utilities over MCP: shorten URLs, screenshot pages, read page metadata, encode URLs.
Related MCP Servers
- FlicenseBqualityDmaintenanceA MCP server that allows you to search and retrieve content on any wiki site using MediaWiki with LLMs 🤖. wikipedia.org, fandom.com, wiki.gg and more sites using Mediawiki are supported!227-
- AlicenseBqualityBmaintenanceA secure MCP server for interacting with MediaWiki instances, allowing users to search, read, create, and manage wiki content like pages, categories, and files. It supports both public and private wikis with comprehensive authentication for full read and write operations.19AGPL 3.0
- AlicenseAqualityAmaintenanceMCP server for MediaWiki wikis. Search, read, edit, and manage wiki content from AI assistants. Includes formatting, link checking, revision history, and markdown conversion.4324MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables full management of WikiJS instances, supporting operations like page creation, searching, and updating. It also provides tools for knowledge graph exploration, content summarization, and retrieval of wiki statistics.19 npmMIT