wikijs-mcp

Servidor MCP para acceder a Wiki.js a través de GraphQL API, construido con FastMCP (Python).

Herramientas expuestas

El dominio mail exige el permiso manage:system. A diferencia de otros dominios, las dos herramientas mail solo se pueden usar con una API key de Wiki.js del grupo Administrators (permiso manage:system). wikijs_mail_update_config también es REEMPLAZAR-TODO: una sola llamada sobrescribe toda la configuración de correo de la instancia, no solo el campo mencionado.

El dominio storage también exige el permiso manage:system. Las tres herramientas storage solo se pueden usar con una API key del grupo de Administradores. El Sync forzado (botón en Admin → Storage) se ejecuta con wikijs_storage_action_execute(target_key="git", handler="sync"). wikijs_storage_target_list censura los valores de configuración que son credenciales (basicPassword, sshPrivateKey) mostrando *** — el valor real no se puede recuperar a través de MCP. Los handlers no están en la lista blanca: usa las acciones de wikijs_storage_target_list para encontrar los handlers disponibles, y ten en cuenta que algunos son destructivos (purge borra el repositorio Git local, importAll sobrescribe el contenido del wiki desde el repositorio local).

wikijs_storage_target_update(target_key, is_enabled, mode, config) cambia la configuración de un objetivo con semántica replace-all: un solo argumento sobrescribe toda la configuración del objetivo. config se fusiona por clave, pero si se pasa config como null se elimina toda la configuración. Las mutaciones de Wiki.js subyacentes son REPLACE-ALL, por lo que la herramienta realiza una lectura-modificación-escritura para evitar borrar claves no especificadas. Las claves de config que no existen en el objetivo se ignoran; si se pasa config con una clave desconocida, se produce un error.

El dominio storage también exige el permiso manage:system. Las cuatro herramientas de storage solo se pueden usar con una API key de un miembro del grupo Administrators (permiso manage:system). La sincronización forzada (botón en Administración → Storage) se ejecuta con wikijs_storage_action_execute(target_key="git", handler="sync"). wikijs_storage_target_list censura los valores de configuración sensibles (basicPassword, sshPrivateKeyContent) mostrando ***: el valor original no se puede leer a través de MCP. Los manejadores no están en una lista blanca: usa actions de wikijs_storage_target_list para ver los disponibles y ten en cuenta que algunos son destructivos (purge elimina el repositorio Git local, importAll sobrescribe el contenido del wiki desde el repositorio local).

wikijs_storage_target_update actualiza un solo objetivo con semántica de actualización parcial: los argumentos no especificados significan «no cambiar». La mutación subyacente de Wiki.js es REPLACE-ALL, por lo que la herramienta lee, modifica y escribe para no perder campos omitidos. Las claves de config deben existir en el objetivo; de lo contrario, se devuelve un error.

Related MCP server: mcp-wikijs-mv

Configuración

Copia .env.example a .env y completa los valores correspondientes:

Variables obligatorias

cp .env.example .env

Cómo usar

stdio (Claude Desktop / VS Code)

{
  "mcpServers": {
    "wikijs": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/andhit-r/wikijs-mcp", "wikijs-mcp"],
      "env": {
        "WIKIJS_URL": "https://wiki.example.com",
        "WIKIJS_API_KEY": "your-api-key"
      }
    }
  }
}

HTTP + API Key (Claude Code / VS Code remoto)

docker run -p 8000:8000 \
  -e WIKIJS_URL=https://wiki.example.com \
  -e WIKIJS_API_KEY=your-wikijs-api-key \
  -e MCP_API_KEY=your-mcp-api-key \
  ghcr.io/andhit-r/wikijs-mcp:latest

HTTP + Authentik

docker run -p 8000:8000 --env-file .env ghcr.io/andhit-r/wikijs-mcp:latest

Licencia

MIT