
A MCP Server for browsing the official Minecraft Wiki!
A MCP Server for browsing the official Minecraft Wiki!
·
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/mcpwithout installing or running anything locally! See Streamable HTTP Transport below for instructions.
# 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-mcppip install -e .
minecraft-wiki-mcpAdd to your claude_desktop_config.json:
{
"mcpServers": {
"minecraft-wiki": {
"command": "uv",
"args": [
"--directory", "/path/to/Minecraft-Wiki-MCP",
"run", "minecraft-wiki-mcp"
]
}
}
}claude mcp add minecraft-wiki -- uv --directory /path/to/Minecraft-Wiki-MCP run minecraft-wiki-mcpBy 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"
}
}
}
}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-httpThen 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/mcpOr for a local server:
claude mcp add --transport http minecraft-wiki http://localhost:8000/mcpThe 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/mcpClaude (Web & Desktop) & Perplexity:
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:
https://minecraft-wiki-mcp.goett.top/mcp as the MCP server URL to connect.Configure host, port, and security via environment variables:
| Variable | Default | Description |
|---|---|---|
MINECRAFT_WIKI_HOST | 127.0.0.1 | Host to bind the HTTP server to |
MINECRAFT_WIKI_PORT | 8000 | Port for the HTTP server |
MINECRAFT_WIKI_API_URL | https://minecraft.wiki/api.php | MediaWiki API endpoint |
MINECRAFT_WIKI_ENABLE_SECURITY | Auto | Enforce DNS rebinding protection (Host/Origin header check). Defaults to true if hosting on localhost/loopback, and false otherwise (e.g. when binding to 0.0.0.0 on a VPS). |
MINECRAFT_WIKI_ALLOWED_HOSTS | Auto | Comma-separated list of allowed Host headers. (e.g. mcp.example.com:*,123.45.67.89:*). Only active if security is enabled. |
MINECRAFT_WIKI_ALLOWED_ORIGINS | Auto | Comma-separated list of allowed Origin headers. (e.g. https://mcp.example.com:*). Only active if security is enabled. |
| Tool | Description |
|---|---|
minecraft_wiki_search | Search for pages by name (items, blocks, entities, structures) |
minecraft_wiki_get_page | Get page summary + section list, or full page content |
minecraft_wiki_get_section | Read a specific section's raw wikitext |
minecraft_wiki_resolve_redirect | Check if a title redirects and find the target |
| Tool | Description |
|---|---|
minecraft_wiki_get_categories | Get categories for a page, or browse categories by prefix |
minecraft_wiki_get_category_members | List all pages in a category |
For best results, LLMs should follow this pattern:
minecraft_wiki_search to find the right pageminecraft_wiki_get_page to see the intro and available sectionsminecraft_wiki_get_section to read specific sections# 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.pyA 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!
v2 is a complete rewrite from TypeScript to Python. Key changes:
| v1 Tool | v2 Tool | Notes |
|---|---|---|
MinecraftWiki_searchWiki | minecraft_wiki_search | Renamed |
MinecraftWiki_getPageSummary | minecraft_wiki_get_page | Now includes section list |
MinecraftWiki_getPageContent | minecraft_wiki_get_page | Use include_all_content=true |
MinecraftWiki_getSectionsInPage | minecraft_wiki_get_page | Section list included in response |
MinecraftWiki_getPageSection | minecraft_wiki_get_section | Returns wikitext instead of stripped HTML |
MinecraftWiki_getCategoriesForPage | minecraft_wiki_get_categories | Pass title parameter |
MinecraftWiki_listAllCategories | minecraft_wiki_get_categories | Pass prefix parameter |
MinecraftWiki_listCategoryMembers | minecraft_wiki_get_category_members | Renamed |
MinecraftWiki_resolveRedirect | minecraft_wiki_resolve_redirect | Renamed |
Other breaking changes:
MINECRAFT_WIKI_API_URL env var instead of --api-url CLI flaguv instead of Node.jsPick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add minecraft-wiki -- uv --directory /path/to/Minecraft-Wiki-MCP run minecraft-wiki-mcp{
"mcpServers": {
"minecraft-wiki": {
"args": [
"--directory",
"/path/to/Minecraft-Wiki-MCP",
"run",
"minecraft-wiki-mcp"
],
"command": "uv"
}
}
}code --add-mcp '{"name":"minecraft-wiki","args":["--directory","/path/to/Minecraft-Wiki-MCP","run","minecraft-wiki-mcp"],"command":"uv"}'[mcp_servers.minecraft-wiki]
command = "uv"
args = ["--directory", "/path/to/Minecraft-Wiki-MCP", "run", "minecraft-wiki-mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/minecraft-wiki-mcp to learn what the "Minecraft Wiki MCP" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add minecraft-wiki -- uv --directory /path/to/Minecraft-Wiki-MCP run minecraft-wiki-mcp
claude mcp add --transport http minecraft-wiki https://minecraft-wiki-mcp.goett.top/mcp
claude mcp add --transport http minecraft-wiki http://localhost:8000/mcp| Name | What it does |
|---|---|
minecraft_wiki_search | Search the Minecraft Wiki for pages matching a query. Use simple item, block, entity, or structure names (e.g. 'Creeper', 'Diamond Sword'). Complex queries like 'how to craft X' won't work — search |
minecraft_wiki_get_page | Get a Minecraft Wiki page's summary or full content. By default, returns the lead section (introduction) as Markdown plus a list of all page sections with their indices. This helps you decide which |
minecraft_wiki_get_section | Get a specific section from a Minecraft Wiki page as clean Markdown. Use ``minecraft_wiki_get_page`` first to see available sections and their indices, then call this tool with the desired section in |
minecraft_wiki_get_categories | Get categories for a page or browse available categories. Two modes: - If ``title`` is provided: returns the categories that page belongs to. - If ``prefix`` is provided (and no ``title``): lists cat |
minecraft_wiki_get_category_members | List all pages belonging to a specific Minecraft Wiki category. Provide the category name without the 'Category:' prefix (e.g. 'Hostile mobs', 'Items', 'Blocks'). |
minecraft_wiki_resolve_redirect | Resolve a page redirect to its target page title. Most other tools already resolve redirects automatically, but this tool is useful when you specifically need to know whether a title is a redirect an |
Read live from the server on November 15, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/minecraft-wiki-mcp)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "minecraft-wiki-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.