MediaWiki MCP Server

Servidor MCP de MediaWiki

Un servidor MCP (Model Context Protocol) que permite a clientes de Modelos de Lenguaje Grande (LLM) interactuar con cualquier wiki de MediaWiki.

Características

Herramientas

Cada herramienta que opera sobre una wiki acepta un argumento opcional wiki que nombra la wiki sobre la que actuar (las herramientas de gestión de wikis y OAuth no lo aceptan): pasa una clave de wiki (p. ej. en.wikipedia.org) o la URI completa de mcp://wikis/{wikiKey}. Omítelo para usar la wiki predeterminada configurada (ver Configuración). Cada respuesta de herramienta informa sobre la wiki en la que se ejecutó la llamada. Cada respuesta exitosa lleva su contenido como prosa en content y como JSON en structuredContent; ver canales de respuesta.

Lecturas de páginas

Escrituras de páginas

Gestión de wikis

OAuth

Paquetes de extensiones

Las herramientas de cada paquete se registran solo en wikis donde su extensión está instalada.

NeoWiki

Semantic MediaWiki

Bucket

Cargo

Wikibase

Recursos

mcp://wikis/{wikiKey} — recurso por wiki que expone sitename, server (la dirección pública de la wiki), articlepath, scriptpath y las banderas private y readOnly.

• Esos campos son todo el contenido: el recurso publica una lista fija, por lo que las credenciales y la configuración del lado del servidor en tu archivo de configuración nunca se exponen en el contenido del recurso.
• Después de add-wiki o remove-wiki, el servidor envía notifications/resources/list_changed para que los clientes se actualicen.

{
  "contents": [
    {
      "uri": "mcp://wikis/en.wikipedia.org",
      "mimeType": "application/json",
      "text": "{ \"sitename\":\"Wikipedia\",\"server\":\"https://en.wikipedia.org\",\"articlepath\":\"/wiki\",\"scriptpath\":\"/w\",\"private\":false }"
    }
  ]
}

Variables de entorno

Las variables siguientes son relevantes para cualquier configuración. Las variables que solo aplican al autoalojar el transporte HTTP (puertos, tiempos de espera, protecciones de Host/Origin y SSRF) o al ejecutar el proxy OAuth alojado están en docs/deployment.md — variables de entorno. Las variables de sustitución de archivos de configuración y directorios de subida están en docs/configuration.md.

Configuración

[!NOTE] La configuración solo es necesaria al interactuar con una wiki privada o al usar herramientas autenticadas.

Crea un archivo config.json para configurar conexiones de wiki. Usa el config.example.json como punto de partida.

{
  "defaultWiki": "en.wikipedia.org",
  "wikis": {
    "en.wikipedia.org": {
      "sitename": "Wikipedia",
      "server": "https://en.wikipedia.org",
      "articlepath": "/wiki",
      "scriptpath": "/w"
    }
  }
}

Dirección interna vs. pública. El server que configures puede ser un nombre de host interno (p. ej. http://mediawiki en Docker); las URLs devueltas al llamante se construyen a partir de la dirección pública de la wiki, por lo que los nombres de host internos no se filtran en los enlaces. Ver docs/configuration.md — campos por wiki.

Para la referencia completa de campos, sustitución de variables de entorno, fuentes de secretos, etiquetas de cambios, directorios de subida y opciones de autenticación, ver docs/configuration.md.

Autenticación

Las herramientas marcadas con 🔐 requieren autenticación. Las herramientas de escritura (incluidas las escrituras de paquetes de extensiones) se rechazan en una wiki que tenga readOnly: true, y se ocultan de tools/list cuando cada wiki configurada la tiene — ver Implementación.

• OAuth basado en navegador (recomendado). Inicia sesión a través de una pestaña del navegador la primera vez que una herramienta necesite autenticación. Establece oauth2ClientId y oauth2CallbackPort por wiki — ver docs/configuration.md — OAuth (basado en navegador).
• Token de portador por solicitud (HTTP), obsoleto. Cada solicitud lleva Authorization: Bearer <token> y el servidor lo reenvía a MediaWiki. Desactivado por defecto, porque un servidor MCP no debe aceptar tokens que no fueron emitidos para él. Ver docs/deployment.md — token de portador por solicitud.
• Proxy OAuth alojado (HTTP). El servidor presenta un consumidor de MediaWiki como un Servidor de Autorización OAuth 2.1, de modo que un cliente consciente de OAuth registra a cada usuario — sin tokens manuales. Apúntalo a https://<wiki>/mcp; la lectura anónima aún funciona. Ver docs/deployment.md — inicio de sesión OAuth alojado.
• Token de acceso OAuth2 manual. Pega un token de larga duración en config.json. Ver docs/configuration.md — token de acceso OAuth2 manual.
• Contraseña de bot. Respaldo cuando Extension:OAuth no está instalada. Ver docs/configuration.md — contraseña de bot. Las herramientas Cargo (cargo-query, cargo-list-tables, cargo-describe-table) llaman a acciones de API restringidas por el permiso de usuario runcargoqueries. La mayoría de los wikis otorgan este permiso a todos los usuarios por defecto; los wikis que lo restringen requieren la concesión Create, query and delete data through the Cargo extension en la contraseña de bot o en el consumidor OAuth. La extensión Cargo también se detecta en wikis alojados en wiki.gg (Helldivers, Terraria, Ark, etc.), donde se distribuye bajo el nombre renombrado LIBRARIAN.

Instalación

Elige tu cliente a continuación, o usa la configuración estándar si no aparece en la lista. CONFIG es opcional; sin él, el servidor apunta a la Wikipedia en inglés. Para apuntarlo a tu propio wiki y configurar la autenticación para escrituras, consulta docs/configuration.md.

Claude Code

Añade este repositorio como mercado de plugins y luego instala el servidor incluido:

/plugin marketplace add ProfessionalWiki/MediaWiki-MCP-Server
/plugin install mediawiki-mcp-server@professional-wiki

El plugin acepta un archivo de configuración opcional, que apunta el servidor a tu propio wiki. Configúralo desde el mensaje al habilitar el plugin, o en cualquier momento con /plugin configure mediawiki-mcp-server@professional-wiki. Una instalación desde línea de comandos toma el mismo valor mediante claude plugin install mediawiki-mcp-server@professional-wiki --config configPath=path/to/config.json.

Cuando se instala como plugin, las herramientas tienen el prefijo de espacio de nombres mcp__plugin_mediawiki-mcp-server_mediawiki__<tool>; actualiza cualquier lista de permitidos o enlaces de herramientas en consecuencia.

Para configurar el servidor directamente, consulta la documentación de MCP para Claude Code. La versión resumida:

claude mcp add mediawiki-mcp-server -- npx -y @professional-wiki/mediawiki-mcp-server@latest
# Environment variables go before the `--`:
claude mcp add mediawiki-mcp-server -e CONFIG=path/to/config.json -- npx -y @professional-wiki/mediawiki-mcp-server@latest

Codex

Añade este repositorio como mercado de plugins y luego instala el servidor incluido:

codex plugin marketplace add ProfessionalWiki/MediaWiki-MCP-Server
codex plugin add mediawiki-mcp-server@professional-wiki

Para apuntar el plugin a tu propio wiki, establece CONFIG en el shell desde el que lanzas Codex, por ejemplo export CONFIG=path/to/config.json. Codex no tiene configuración por plugin; si prefieres no establecer una variable de entorno, codex mcp add mediawiki --env CONFIG=path/to/config.json -- npx -y @professional-wiki/mediawiki-mcp-server@latest registra el servidor directamente y tiene prioridad sobre la copia del plugin.

Consulta la documentación de plugins de Codex para saber cómo listar, actualizar o eliminar plugins.

Claude Desktop

Descarga MediaWiki-MCP-Server.mcpb y haz doble clic para instalar la extensión, que te pedirá la ruta de un archivo de configuración para que puedas apuntarla a tu propio wiki en lugar de a la Wikipedia en inglés.

VS Code y Cursor

O añade la configuración estándar manualmente.

Antigravity

Añade la configuración estándar a la configuración MCP de Antigravity, ya sea globalmente en ~/.gemini/config/mcp_config.json o por espacio de trabajo en .agents/mcp_config.json.

Si instalaste previamente la extensión de Gemini CLI, el asistente de configuración de Antigravity ofrece importar tu configuración existente de Gemini CLI.

OpenCode

OpenCode usa su propia forma de configuración en lugar de mcpServers; añade esto a opencode.json en la raíz de tu proyecto, o ~/.config/opencode/opencode.json para una instalación global.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mediawiki-mcp-server": {
      "type": "local",
      "command": ["npx", "-y", "@professional-wiki/mediawiki-mcp-server@latest"],
      "environment": {
        "CONFIG": "path/to/config.json"
      }
    }
  }
}

Configuración estándar

La mayoría de los clientes leen el mismo bloque de servidor. Pégalo en el archivo indicado para tu cliente, reemplazando mcpServers con la clave raíz de ese cliente:

{
  "mcpServers": {
    "mediawiki-mcp-server": {
      "command": "npx",
      "args": ["-y", "@professional-wiki/mediawiki-mcp-server@latest"],
      "env": {
        "CONFIG": "path/to/config.json"
      }
    }
  }
}

Para cualquier otro cliente, npx add-mcp @professional-wiki/mediawiki-mcp-server puede funcionar: add-mcp es un CLI comunitario que escribe el archivo de configuración de tu cliente por ti. Solo establece el comando de lanzamiento; añade CONFIG tú mismo para apuntar a tu propio wiki.

Despliegue

Ejecutar el servidor como un endpoint HTTP remoto para otros usuarios tiene sus propios requisitos de configuración — consulta docs/deployment.md. Hay una imagen precompilada publicada en ghcr.io/professionalwiki/mediawiki-mcp-server. Para operaciones de día 2 (registros, /health//ready, métricas, apagado elegante), consulta docs/operations.md.

Seguridad

Los valores predeterminados son seguros para uso de un solo usuario. Antes de exponer el transporte HTTP a otros, asegura tres cosas:

• Termina TLS en tu proxy inverso. No expongas el puerto MCP directamente en una red no confiable. Consulta docs/deployment.md — lista de verificación de seguridad.
• Combina MCP_BIND con MCP_ALLOWED_HOSTS y MCP_ALLOWED_ORIGINS. El transporte HTTP se vincula a 127.0.0.1 por defecto. Cuando lo abras con MCP_BIND=0.0.0.0, establece MCP_ALLOWED_HOSTS a los nombres de host que tu proxy reenvía y MCP_ALLOWED_ORIGINS a los orígenes de navegador permitidos para llamar al servidor — estos bloquean ataques de reenlace de DNS y de origen cruzado, respectivamente.
• Las subidas son opcionales. upload-file está deshabilitado hasta que enumeres los directorios permitidos en uploadDirs o MCP_UPLOAD_DIRS. Consulta docs/configuration.md — directorios de subida.
• Los destinos internos necesitan MCP_TRUSTED_HOSTS. Las búsquedas salientes están protegidas contra SSRF: un destino que resuelve a una dirección privada o de bucle local (por ejemplo, un alias de red Docker como mediawiki.svc) se rechaza hasta que enumeres su host en MCP_TRUSTED_HOSTS. Consulta docs/deployment.md — protección SSRF saliente.

Reporta una vulnerabilidad mediante el formulario de aviso de seguridad de GitHub — política completa en SECURITY.md.

Contribuciones

Las contribuciones son bienvenidas — tanto las solicitudes de extracción como los problemas (errores, solicitudes de funciones, sugerencias) funcionan.

• ¿Trabajas en código de herramientas? Comienza con AGENTS.md para la estructura del repositorio, comandos y patrones de prueba.
• ¿Añades o modificas una herramienta? Lee docs/tool-conventions.md — cubre el tono de las descripciones, la documentación de parámetros, las sugerencias de anotaciones y las convenciones de terminología de MediaWiki.
• ¿Preparas un lanzamiento? Consulta docs/releasing.md.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.