Minecraft Wiki MCP

Un servidor para navegar y buscar en la wiki oficial de Minecraft.

Documentación

Minecraft Wiki MCP

Un servidor MCP para navegar por la wiki oficial de Minecraft.

[!WARNING] Esta es la v2: una reescritura completa en Python. Si estás actualizando desde la v1 (TypeScript), consulta las notas de migración a continuación.

[!TIP] Instancia pública alojada: Puedes conectarte a la instancia pública alojada de este servidor directamente en https://minecraft-wiki-mcp.goett.top/mcp sin instalar ni ejecutar nada localmente. Consulta Transporte HTTP Streamable a continuación para obtener instrucciones.

Características

Búsqueda en la wiki — Encuentra información sobre estructuras, entidades, objetos y bloques de Minecraft
Resúmenes de páginas — Obtén la introducción de una página más una tabla de contenidos para navegar más a fondo
Acceso a secciones — Lee secciones específicas como wikitexto sin procesar
Contenido completo de la página — Recupera la página completa cuando necesites todo
Exploración de categorías — Explora las categorías de la wiki y sus páginas miembro
Resolución de redirecciones — Sigue redirecciones para encontrar la página canónica
Soporte multilingüe — Conéctate a cualquier versión de idioma de la wiki de Minecraft

Requisitos

Python 3.12+
uv (gestor de paquetes recomendado)

Instalación

Inicio rápido con 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

Con pip

pip install -e .
minecraft-wiki-mcp

Configuración

Claude Desktop

Añade a tu 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

Soporte multilingüe

Por defecto, el servidor se conecta a la wiki en inglés (https://minecraft.wiki/api.php). Establece la variable de entorno MINECRAFT_WIKI_API_URL para usar un 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"
      }
    }
  }
}

Transporte HTTP Streamable

Por defecto, el servidor utiliza el transporte stdio (comunicación a través de stdin/stdout). Para acceso remoto o con múltiples clientes, puedes usar el transporte HTTP Streamable:

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

Luego conecta los clientes al endpoint HTTP. Por ejemplo, para conectarte a la instancia pública alojada usando Claude Code:

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

O para un servidor local:

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

Conexión de plataformas principales a la instancia pública

La URL pública alojada https://minecraft-wiki-mcp.goett.top/mcp se puede añadir fácilmente en las principales plataformas que admiten conexiones MCP remotas o aplicaciones personalizadas:

Claude Code:

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

Claude (Web y escritorio) y Perplexity:
1. Abre tu página de configuración/personalización (por ejemplo, Personalizar -> Conectores en Claude).
2. Selecciona la opción de añadir un servidor remoto usando el transporte HTTP/SSE.
3. Introduce https://minecraft-wiki-mcp.goett.top/mcp como URL del servidor.
Sitio web de ChatGPT (aplicaciones personalizadas): ChatGPT admite conectar servidores MCP personalizados de forma nativa (incluso en el nivel gratuito) cuando el modo desarrollador está habilitado:
1. Abre Configuración de ChatGPT -> Aplicaciones -> Configuración avanzada y habilita el Modo desarrollador.
2. Vuelve atrás y crea una nueva aplicación.
3. Introduce https://minecraft-wiki-mcp.goett.top/mcp como URL del servidor MCP para conectarte.

Configuración

Configura el host, el puerto y la seguridad mediante variables de entorno:

Variable	Predeterminado	Descripción
`MINECRAFT_WIKI_HOST`	`127.0.0.1`	Host al que vincular el servidor HTTP
`MINECRAFT_WIKI_PORT`	`8000`	Puerto para el servidor HTTP
`MINECRAFT_WIKI_API_URL`	`https://minecraft.wiki/api.php`	Endpoint de la API de MediaWiki
`MINECRAFT_WIKI_ENABLE_SECURITY`	Automático	Aplicar protección contra el rebinding de DNS (verificación de cabeceras Host/Origin). El valor predeterminado es `true` si se aloja en localhost/loopback, y `false` en caso contrario (por ejemplo, al vincular a `0.0.0.0` en un VPS).
`MINECRAFT_WIKI_ALLOWED_HOSTS`	Automático	Lista separada por comas de cabeceras `Host` permitidas. (por ejemplo, `mcp.example.com:,123.45.67.89:`). Solo activa si la seguridad está habilitada.
`MINECRAFT_WIKI_ALLOWED_ORIGINS`	Automático	Lista separada por comas de cabeceras `Origin` permitidas. (por ejemplo, `https://mcp.example.com:*`). Solo activa si la seguridad está habilitada.

Herramientas disponibles

Búsqueda y navegación

Herramienta	Descripción
`minecraft_wiki_search`	Busca páginas por nombre (objetos, bloques, entidades, estructuras)
`minecraft_wiki_get_page`	Obtén el resumen de la página + lista de secciones, o el contenido completo de la página
`minecraft_wiki_get_section`	Lee el wikitexto sin procesar de una sección específica
`minecraft_wiki_resolve_redirect`	Comprueba si un título redirige y encuentra el destino

Categorías

Herramienta	Descripción
`minecraft_wiki_get_categories`	Obtén categorías para una página, o explora categorías por prefijo
`minecraft_wiki_get_category_members`	Lista todas las páginas de una categoría

Flujo de trabajo recomendado

Para obtener los mejores resultados, los LLM deben seguir este patrón:

Buscar — minecraft_wiki_search para encontrar la página correcta
Resumir — minecraft_wiki_get_page para ver la introducción y las secciones disponibles
Profundizar — minecraft_wiki_get_section para leer secciones específicas

Desarrollo

# 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

Agradecimientos

Un agradecimiento especial a stone-brick por desarrollar la fantástica biblioteca minecraft-wiki-MDifier. Esta biblioteca convierte el complejo wikitexto de Minecraft en Markdown limpio y fácil de leer, lo que no solo mejora los resultados de análisis del servidor MCP, sino que también ahorra significativamente el uso de tokens para los LLM. ¡Gracias por la ayuda y por construir esta gran biblioteca!

Migración desde la v1

La v2 es una reescritura completa de TypeScript a Python. Cambios clave:

Herramienta v1	Herramienta v2	Notas
`MinecraftWiki_searchWiki`	`minecraft_wiki_search`	Renombrada
`MinecraftWiki_getPageSummary`	`minecraft_wiki_get_page`	Ahora incluye lista de secciones
`MinecraftWiki_getPageContent`	`minecraft_wiki_get_page`	Usa `include_all_content=true`
`MinecraftWiki_getSectionsInPage`	`minecraft_wiki_get_page`	Lista de secciones incluida en la respuesta
`MinecraftWiki_getPageSection`	`minecraft_wiki_get_section`	Devuelve wikitexto en lugar de HTML sin etiquetas
`MinecraftWiki_getCategoriesForPage`	`minecraft_wiki_get_categories`	Pasa el parámetro `title`
`MinecraftWiki_listAllCategories`	`minecraft_wiki_get_categories`	Pasa el parámetro `prefix`
`MinecraftWiki_listCategoryMembers`	`minecraft_wiki_get_category_members`	Renombrada
`MinecraftWiki_resolveRedirect`	`minecraft_wiki_resolve_redirect`	Renombrada

Otros cambios importantes:

Configuración mediante la variable de entorno MINECRAFT_WIKI_API_URL en lugar de la opción de línea de comandos --api-url
Tiempo de ejecución: Python 3.12+ con uv en lugar de Node.js
El contenido es wikitexto sin procesar en lugar de texto sin etiquetas HTML