Minecraft Wiki MCP

Um servidor para navegar e pesquisar a Wiki oficial do Minecraft.

Documentação

Minecraft Wiki MCP

Um servidor MCP para navegar na Wiki oficial do Minecraft!

[!WARNING] Esta é a v2 — uma reescrita completa em Python. Se você está atualizando da v1 (TypeScript), veja as notas de migração abaixo.

[!TIP] Instância Pública Hospedada: Você pode se conectar à instância pública hospedada deste servidor diretamente em https://minecraft-wiki-mcp.goett.top/mcp sem instalar ou executar nada localmente! Veja Streamable HTTP Transport abaixo para instruções.

Recursos

Pesquisa na Wiki — Encontre informações sobre estruturas, entidades, itens e blocos do Minecraft
Resumos de Página — Obtenha a introdução de uma página mais um sumário para navegar adiante
Acesso a Seções — Leia seções específicas como wikitexto bruto
Conteúdo Completo da Página — Recupere a página inteira quando precisar de tudo
Navegação por Categorias — Explore categorias da wiki e suas páginas membros
Resolução de Redirecionamentos — Siga redirecionamentos para encontrar a página canônica
Suporte a Múltiplos Idiomas — Conecte-se a qualquer versão de idioma da Wiki do Minecraft

Requisitos

Python 3.12+
uv (gerenciador de pacotes recomendado)

Instalação

Início Rápido com 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

Com pip

pip install -e .
minecraft-wiki-mcp

Configuração

Claude Desktop

Adicione ao seu 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

Suporte a Múltiplos Idiomas

Por padrão, o servidor se conecta à wiki em inglês (https://minecraft.wiki/api.php). Defina a variável de ambiente MINECRAFT_WIKI_API_URL para usar um idioma diferente:

{
  "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

Por padrão, o servidor usa transporte stdio (comunicação via stdin/stdout). Para acesso remoto ou com múltiplos clientes, você pode usar o transporte Streamable HTTP:

# Start the HTTP server (default: http://127.0.0.1:8000/mcp)
uv run minecraft-wiki-mcp --transport streamable-http

Em seguida, conecte os clientes ao endpoint HTTP. Por exemplo, para conectar à instância pública hospedada usando Claude Code:

claude mcp add --transport http minecraft-wiki https://minecraft-wiki-mcp.goett.top/mcp

Ou para um servidor local:

claude mcp add --transport http minecraft-wiki http://localhost:8000/mcp

Conectando Principais Plataformas à Instância Pública

A URL pública hospedada https://minecraft-wiki-mcp.goett.top/mcp pode ser facilmente adicionada em principais plataformas que suportam conexões MCP remotas ou aplicativos personalizados:

Claude Code:

claude mcp add --transport http minecraft-wiki https://minecraft-wiki-mcp.goett.top/mcp

Claude (Web & Desktop) & Perplexity:
1. Abra sua página de configurações/personalização (ex.: Customize -> Connectors no Claude).
2. Selecione a opção de adicionar um servidor remoto usando o transporte HTTP/SSE.
3. Insira https://minecraft-wiki-mcp.goett.top/mcp como a URL do servidor.
Site do ChatGPT (Aplicativos Personalizados): O ChatGPT suporta conectar servidores MCP personalizados nativamente (até mesmo no plano gratuito) quando o modo desenvolvedor está ativado:
1. Abra Configurações do ChatGPT -> Apps -> Configurações Avançadas e ative o Modo Desenvolvedor.
2. Volte e crie um novo aplicativo.
3. Insira https://minecraft-wiki-mcp.goett.top/mcp como a URL do servidor MCP para conectar.

Configuração

Configure host, porta e segurança por meio de variáveis de ambiente:

Variável	Padrão	Descrição
`MINECRAFT_WIKI_HOST`	`127.0.0.1`	Host para vincular o servidor HTTP
`MINECRAFT_WIKI_PORT`	`8000`	Porta para o servidor HTTP
`MINECRAFT_WIKI_API_URL`	`https://minecraft.wiki/api.php`	Endpoint da API MediaWiki
`MINECRAFT_WIKI_ENABLE_SECURITY`	Auto	Aplicar proteção contra rebinding de DNS (verificação de cabeçalho Host/Origin). Padrão é `true` se hospedado em localhost/loopback, e `false` caso contrário (ex.: ao vincular a `0.0.0.0` em um VPS).
`MINECRAFT_WIKI_ALLOWED_HOSTS`	Auto	Lista separada por vírgulas de cabeçalhos `Host` permitidos. (ex.: `mcp.example.com:,123.45.67.89:`). Ativo apenas se a segurança estiver habilitada.
`MINECRAFT_WIKI_ALLOWED_ORIGINS`	Auto	Lista separada por vírgulas de cabeçalhos `Origin` permitidos. (ex.: `https://mcp.example.com:*`). Ativo apenas se a segurança estiver habilitada.

Ferramentas Disponíveis

Pesquisa e Navegação

Ferramenta	Descrição
`minecraft_wiki_search`	Pesquisar páginas por nome (itens, blocos, entidades, estruturas)
`minecraft_wiki_get_page`	Obter resumo da página + lista de seções, ou conteúdo completo da página
`minecraft_wiki_get_section`	Ler o wikitexto bruto de uma seção específica
`minecraft_wiki_resolve_redirect`	Verificar se um título redireciona e encontrar o destino

Categorias

Ferramenta	Descrição
`minecraft_wiki_get_categories`	Obter categorias de uma página, ou navegar por categorias por prefixo
`minecraft_wiki_get_category_members`	Listar todas as páginas em uma categoria

Fluxo de Trabalho Recomendado

Para melhores resultados, os LLMs devem seguir este padrão:

Pesquisar — minecraft_wiki_search para encontrar a página certa
Resumir — minecraft_wiki_get_page para ver a introdução e as seções disponíveis
Aprofundar — minecraft_wiki_get_section para ler seções específicas

Desenvolvimento

# 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

Agradecimentos

Um agradecimento especial a stone-brick por desenvolver a fantástica biblioteca minecraft-wiki-MDifier! Esta biblioteca converte wikitexto complexo do Minecraft em Markdown limpo e fácil de ler, o que não apenas melhora os resultados de análise do servidor MCP, mas também economiza significativamente o uso de tokens para LLMs. Obrigado pela ajuda e por construir esta ótima biblioteca!

Migrando da v1

A v2 é uma reescrita completa de TypeScript para Python. Principais mudanças:

Ferramenta v1	Ferramenta v2	Notas
`MinecraftWiki_searchWiki`	`minecraft_wiki_search`	Renomeada
`MinecraftWiki_getPageSummary`	`minecraft_wiki_get_page`	Agora inclui lista de seções
`MinecraftWiki_getPageContent`	`minecraft_wiki_get_page`	Use `include_all_content=true`
`MinecraftWiki_getSectionsInPage`	`minecraft_wiki_get_page`	Lista de seções incluída na resposta
`MinecraftWiki_getPageSection`	`minecraft_wiki_get_section`	Retorna wikitexto em vez de HTML sem marcação
`MinecraftWiki_getCategoriesForPage`	`minecraft_wiki_get_categories`	Passe o parâmetro `title`
`MinecraftWiki_listAllCategories`	`minecraft_wiki_get_categories`	Passe o parâmetro `prefix`
`MinecraftWiki_listCategoryMembers`	`minecraft_wiki_get_category_members`	Renomeada
`MinecraftWiki_resolveRedirect`	`minecraft_wiki_resolve_redirect`	Renomeada

Outras mudanças que quebram compatibilidade:

Configuração via variável de ambiente MINECRAFT_WIKI_API_URL em vez do sinalizador CLI --api-url
Runtime: Python 3.12+ com uv em vez de Node.js
Conteúdo é wikitexto bruto em vez de texto sem HTML