Servidor MCP de MediaWiki

Conecta tu asistente de IA a cualquier wiki MediaWiki. Busca, lee y edita contenido de la wiki usando lenguaje natural.

Funciona con: Claude Desktop, Claude Code, Cursor, ChatGPT, n8n y cualquier herramienta compatible con MCP.

Documentación

Related MCP server: productplan-mcp-server

¿Qué puedes hacer?

Una vez conectado, simplemente pregúntale a tu IA:

Empezar

Paso 1: Descargar

Opción A: Descargar binario precompilado (más fácil)

Ve a Releases y descarga para tu plataforma.

Opción B: Compilar desde el código fuente (requiere Go 1.24+)

git clone https://github.com/olgasafonova/mediawiki-mcp-server.git
cd mediawiki-mcp-server
go build -o mediawiki-mcp-server .

Paso 2: Encuentra la URL de la API de tu Wiki

La URL de la API de tu wiki suele ser:

Consejo: Visita Special:Version en tu wiki para encontrar el endpoint exacto de la API.

Paso 3: Configura tu herramienta de IA

Elige tu herramienta:

Claude Desktop

Funciona en Mac y Windows. No se necesita terminal después de la configuración inicial.

1. Abre el archivo de configuración:

   open ~/Library/Application\ Support/Claude/claude_desktop_config.json

   Si el archivo no existe, créalo.

2. Añade esta configuración (reemplaza la ruta y la URL):

   {
     "mcpServers": {
       "mediawiki": {
         "command": "/path/to/mediawiki-mcp-server",
         "env": {
           "MEDIAWIKI_URL": "https://your-wiki.com/api.php"
         }
       }
     }
   }

3. Reinicia Claude Desktop (cierra y vuelve a abrir)

4. Pruébalo: Pregunta "Busca en la wiki cómo empezar"

1. Abre el archivo de configuración:

   %APPDATA%\Claude\claude_desktop_config.json

   Si el archivo no existe, créalo.

2. Añade esta configuración (reemplaza la ruta y la URL):

   {
     "mcpServers": {
       "mediawiki": {
         "command": "C:\\path\\to\\mediawiki-mcp-server.exe",
         "env": {
           "MEDIAWIKI_URL": "https://your-wiki.com/api.php"
         }
       }
     }
   }

3. Reinicia Claude Desktop (cierra y vuelve a abrir)

4. Pruébalo: Pregunta "Busca en la wiki cómo empezar"

Claude Code CLI

La configuración más rápida. Un comando y listo.

claude mcp add mediawiki /path/to/mediawiki-mcp-server \
  -e MEDIAWIKI_URL="https://your-wiki.com/api.php"

Pruébalo: Pregunta "Busca en la wiki cómo empezar"

Cursor

Cursor tiene soporte MCP integrado. Abre Cursor Settings > MCP y añade un nuevo servidor, o edita el archivo de configuración directamente:

1. Abre el archivo de configuración:

   ~/.cursor/mcp.json

2. Añade esta configuración:

   {
     "mcpServers": {
       "mediawiki": {
         "command": "/path/to/mediawiki-mcp-server",
         "env": {
           "MEDIAWIKI_URL": "https://your-wiki.com/api.php"
         }
       }
     }
   }

3. Reinicia Cursor

1. Abre el archivo de configuración:

   %USERPROFILE%\.cursor\mcp.json

2. Añade esta configuración:

   {
     "mcpServers": {
       "mediawiki": {
         "command": "C:\\path\\to\\mediawiki-mcp-server.exe",
         "env": {
           "MEDIAWIKI_URL": "https://your-wiki.com/api.php"
         }
       }
     }
   }

3. Reinicia Cursor

ChatGPT

ChatGPT se conecta vía HTTP. Necesitas ejecutar el servidor en una máquina a la que ChatGPT pueda acceder.

Requisitos: Cuenta ChatGPT Pro, Plus, Business, Enterprise o Education.

Configuración

1. Inicia el servidor en modo HTTP:

   # Set your wiki URL
   export MEDIAWIKI_URL="https://your-wiki.com/api.php"
   
   # Generate a secure token
   export MCP_AUTH_TOKEN=$(openssl rand -hex 32)
   echo "Save this token: $MCP_AUTH_TOKEN"
   
   # Start the server
   ./mediawiki-mcp-server -http :8080

2. En ChatGPT:

   • Ve a Settings → Connectors → Advanced → Developer Mode

   • Añade un nuevo conector MCP

   • URL: http://your-server:8080 (debe ser accesible públicamente)

   • Autenticación: Bearer token → pega tu token

3. Pruébalo: Pregunta "Busca en la wiki cómo empezar"

Para producción: Consulta Security Best Practices para la configuración de HTTPS.

n8n

n8n se conecta vía HTTP usando el nodo MCP Client Tool.

Configuración

1. Inicia el servidor en modo HTTP:

   export MEDIAWIKI_URL="https://your-wiki.com/api.php"
   export MCP_AUTH_TOKEN="your-secure-token"
   ./mediawiki-mcp-server -http :8080

2. En n8n:

   • Añade un nodo MCP Client Tool

   • Transport: HTTP Streamable

   • URL: http://your-server:8080

   • Autenticación: Bearer → tu token

3. Habilitar para agentes de IA (añadir al entorno de n8n):

   N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

4. Conecta el nodo MCP Client Tool a un nodo de Agente de IA.

VS Code

VS Code tiene soporte MCP integrado a través de Copilot Chat.

1. Abre la paleta de comandos: Ctrl+Shift+P (Windows) o Cmd+Shift+P (Mac)

2. Escribe "MCP: Add Server" y selecciónalo

3. Elige "Stdio" como tipo de transporte

4. Introduce la ruta al binario cuando se te solicite

5. Ponle nombre al servidor: mediawiki

Esto crea un archivo .vscode/mcp.json. Añade las variables de entorno:

{
  "servers": {
    "mediawiki": {
      "command": "/path/to/mediawiki-mcp-server",
      "env": {
        "MEDIAWIKI_URL": "https://your-wiki.com/api.php"
      }
    }
  }
}

En Windows, usa la ruta .exe con barras invertidas dobles.

Recarga VS Code, luego usa las herramientas de la wiki a través de Copilot Chat.

Google ADK

El Agent Development Kit de Google se conecta a servidores MCP a través de stdio o HTTP Streamable.

import (
    "os/exec"
    "google.golang.org/adk/tool/mcptoolset"
    "github.com/modelcontextprotocol/go-sdk/mcp"
)

// Create MCP toolset for wiki access
wikiTools, _ := mcptoolset.New(mcptoolset.Config{
    Transport: &mcp.CommandTransport{
        Command: exec.Command("/path/to/mediawiki-mcp-server"),
        Env: []string{
            "MEDIAWIKI_URL=https://your-wiki.com/api.php",
        },
    },
})

// Add to your agent
agent := llmagent.New(llmagent.Config{
    Name:     "wiki-agent",
    Model:    model,
    Toolsets: []tool.Set{wikiTools},
})

Primero, inicia el servidor en modo HTTP:

export MEDIAWIKI_URL="https://your-wiki.com/api.php"
./mediawiki-mcp-server -http :8080 -token "your-secret-token"

Luego conéctate desde tu agente ADK:

import (
    "google.golang.org/adk/tool/mcptoolset"
    "github.com/modelcontextprotocol/go-sdk/mcp"
)

wikiTools, _ := mcptoolset.New(mcptoolset.Config{
    Transport: mcp.NewStreamableHTTPClientTransport("http://localhost:8080"),
})

from google.adk.tools.mcp_tool import MCPToolset, StdioConnectionParams, StdioServerParameters

wiki_tools = MCPToolset(
    connection_params=StdioConnectionParams(
        server_params=StdioServerParameters(
            command="/path/to/mediawiki-mcp-server",
            env={"MEDIAWIKI_URL": "https://your-wiki.com/api.php"},
        )
    )
)

Inicia el servidor en modo HTTP, luego:

from google.adk.tools.mcp_tool import MCPToolset, StreamableHTTPConnectionParams

wiki_tools = MCPToolset(
    connection_params=StreamableHTTPConnectionParams(
        url="http://localhost:8080",
        headers={"Authorization": "Bearer your-secret-token"},
    )
)

¿Necesitas editar páginas de la wiki?

La lectura funciona sin inicio de sesión en wikis públicas. Las wikis privadas/corporativas a menudo requieren autenticación para todas las operaciones, incluida la lectura. La edición siempre requiere una contraseña de bot.

Crea una contraseña de bot

1. Inicia sesión en tu wiki

2. Ve a Special:BotPasswords (ej. https://your-wiki.com/wiki/Special:BotPasswords)

3. Introduce un nombre de bot: mcp-assistant

4. Marca estos permisos:

   • ✅ Derechos básicos

   • ✅ Editar páginas existentes

5. Haz clic en Crear y guarda la contraseña (no volverás a verla)

Añade credenciales a tu configuración

Claude Desktop / Cursor:

{
  "mcpServers": {
    "mediawiki": {
      "command": "/path/to/mediawiki-mcp-server",
      "env": {
        "MEDIAWIKI_URL": "https://your-wiki.com/api.php",
        "MEDIAWIKI_USERNAME": "YourWikiUsername@mcp-assistant",
        "MEDIAWIKI_PASSWORD": "your-bot-password-here"
      }
    }
  }
}

Claude Code CLI:

claude mcp add mediawiki /path/to/mediawiki-mcp-server \
  -e MEDIAWIKI_URL="https://your-wiki.com/api.php" \
  -e MEDIAWIKI_USERNAME="YourWikiUsername@mcp-assistant" \
  -e MEDIAWIKI_PASSWORD="your-bot-password-here"

Ejemplos de prompts

📖 Más ejemplos: Consulta WIKI_USE_CASES.md para flujos de trabajo detallados por perfil (editores de contenido, gestores de documentación, desarrolladores).

Buscar y leer

• "¿Qué dice nuestra wiki sobre el despliegue?"

• "Encuentra todas las páginas que mencionan la API"

• "Muéstrame la guía de primeros pasos"

• "Lista todas las páginas en la categoría Documentación"

• "Dame una visión general rápida de la página de Configuración" ✨

• "Obtén el contenido de la Página principal, FAQ y Configuración todo a la vez" ✨

Secciones y contenido relacionado ✨

• "Muéstrame las secciones de la Guía de instalación"

• "Obtén la sección 'Solución de problemas' de la página de FAQ"

• "Encuentra páginas relacionadas con la Referencia de la API"

• "¿Qué imágenes hay en la página de Descripción general del producto?"

Seguimiento de cambios

• "¿Qué páginas se actualizaron esta semana?"

• "¿Quién editó la página de Notas de la versión?"

• "Muéstrame la diferencia entre las dos últimas versiones"

• "¿Quiénes son los editores más activos este mes?" ✨

• "¿Qué páginas se editan con más frecuencia?" ✨

Comprobar calidad

• "¿Hay enlaces rotos en esta página?"

• "Encuentra páginas huérfanas sin enlaces hacia ellas"

• "Comprueba la consistencia de la terminología en la categoría Producto"

• "Encuentra páginas similares a la Guía de instalación" ✨

• "Compara cómo se documenta la 'versión de la API' en las páginas" ✨

• "Encuentra páginas que no se han actualizado en los últimos 90 días" ✨

Gestión de páginas (requiere autenticación) ✨

• "Renombra 'Guía antigua' a 'Guía actualizada'"

• "Añade la categoría 'API' a la página de Integración"

• "Elimina la categoría 'Obsoleto' de esta página"

Ediciones rápidas (requiere autenticación)

• "Tacha a John Smith en la página del Equipo"

• "Reemplaza 'versión 2.0' por 'versión 3.0' en las Notas de la versión"

• "Pon 'API Gateway' en negrita en la página de Arquitectura"

Carga de archivos (requiere autenticación) ✨

• "Sube esta imagen desde la URL a la wiki"

• "Añade el logo desde https://example.com/logo.png como Company_Logo.png"

Búsqueda de archivos ✨

• "Busca 'presupuesto' en File:Annual-Report.pdf"

• "Encuentra menciones de 'API' en el archivo changelog.txt"

Nota: La búsqueda en PDF requiere tener instalado poppler-utils. Consulta PDF Search Setup.

Convertir Markdown ✨

• "Convierte este README al formato wiki"

• "Transforma mis notas de la versión de Markdown a MediaWiki"

• "Convierte con la marca y CSS de Tieto" (usa theme="tieto", add_css=true)

Temas:

• tieto - Colores de marca Tieto (encabezados Hero Blue, resaltado de código amarillo)

• neutral - Salida limpia sin colores personalizados (predeterminado)

• dark - Optimizado para modo oscuro

Encontrar usuarios

• "¿Quiénes son los administradores de la wiki?"

• "Lista todas las cuentas de bot"

Solución de problemas

"MEDIAWIKI_URL environment variable is required" → Comprueba que tu archivo de configuración tenga la ruta y la URL correctas.

"authentication failed" → Comprueba el formato del nombre de usuario: WikiUsername@BotName → Verifica que la contraseña del bot no haya caducado → Asegúrate de que el bot tenga los permisos necesarios

"page does not exist" → Los títulos de las páginas distinguen entre mayúsculas y minúsculas. Comprueba el título exacto en tu wiki.

Las herramientas no aparecen en Claude/Cursor → Reinicia la aplicación después de los cambios de configuración.

ChatGPT no puede conectarse → Asegúrate de que tu servidor sea accesible públicamente (no solo localhost) → Comprueba que el token bearer coincida exactamente

"PDF search requires 'pdftotext'" → Instala poppler-utils para tu plataforma (consulta PDF Search Setup)

Configuración de búsqueda en PDF

La búsqueda en PDF requiere la herramienta `pdft