Un servidor MCP que conecta agentes de IA con una instancia de Wiki.js, permitiéndoles buscar, leer, crear, actualizar y eliminar páginas wiki a través de la API GraphQL de Wiki.js.
Este artículo fue publicado originalmente en las Discussions oficiales de Wiki.js para ayudar a quienes lo necesiten, pero fue eliminado por razones desconocidas, por lo que se reescribe aquí.
requarks-wiki-mcp es un servidor MCP diseñado para que clientes MCP como Claude Code o Claude Desktop puedan utilizar Wiki.js como base de conocimiento.
| Elemento | Valor |
|---|---|
| Paquete | @yowu-dev/requarks-wiki-mcp |
| Versión | v0.3.0 |
| Licencia | MIT |
| Node.js | 20+ |
| Transporte | stdio (stdin/stdout) |
| GitHub | uyu423/requarks-wiki-mcp |
| npm | @yowu-dev/requarks-wiki-mcp |
Agregar al campo mcpServers en ~/.claude.json:
{
"mcpServers": {
"wikijs": {
"command": "npx",
"args": ["-y", "@yowu-dev/requarks-wiki-mcp@latest"],
"env": {
"WIKI_BASE_URL": "https://wiki.your-domain.dev",
"WIKI_API_TOKEN": "your_wikijs_api_key_jwt",
"WIKI_MUTATIONS_ENABLED": "true",
"WIKI_MUTATION_DRY_RUN": "false"
}
}
}
}
| Variable | Requerida | Predeterminado | Descripción |
|---|---|---|---|
WIKI_BASE_URL |
Sí | - | URL base de Wiki.js |
WIKI_API_TOKEN |
Sí | - | JWT de clave API de Wiki.js |
WIKI_GRAPHQL_PATH |
No | /graphql |
Ruta del endpoint GraphQL |
WIKI_DEFAULT_LOCALE |
No | en |
Locale predeterminado |
WIKI_DEFAULT_EDITOR |
No | markdown |
Editor predeterminado |
WIKI_MUTATIONS_ENABLED |
No | false |
Habilitar herramientas de escritura |
WIKI_MUTATION_CONFIRM_TOKEN |
No | (vacío) | Token de seguridad adicional |
WIKI_MUTATION_DRY_RUN |
No | true |
Modo de prueba |
WIKI_ALLOWED_MUTATION_PATH_PREFIXES |
No | (vacío) | Prefijos de ruta permitidos para escritura |
WIKI_HTTP_TIMEOUT_MS |
No | 15000 |
Timeout HTTP (ms) |
WIKI_HTTP_MAX_RETRIES |
No | 2 |
Reintentos máximos para fallos de lectura |
| Herramienta | Descripción |
|---|---|
wikijs_search_pages |
Búsqueda de texto completo en páginas wiki |
wikijs_list_pages |
Listar páginas con filtro de locale y ordenamiento |
wikijs_get_page_by_path |
Obtener página por ruta + locale |
wikijs_get_page_by_id |
Obtener página por ID numérico |
wikijs_get_page_tree |
Explorar jerarquía del sitio |
wikijs_get_page_history |
Ver historial de ediciones |
wikijs_get_page_version |
Obtener contenido de versión específica |
wikijs_get_page_links |
Relaciones de enlaces de página |
| Herramienta | Descripción |
|---|---|
wikijs_list_tags |
Listar todas las etiquetas |
wikijs_search_tags |
Buscar etiquetas |
wikijs_list_comments |
Listar comentarios de una página |
wikijs_get_comment |
Obtener un comentario |
wikijs_get_system_info |
Información del sistema |
wikijs_get_navigation |
Árbol de navegación |
wikijs_get_site_config |
Configuración del sitio |
wikijs_list_assets |
Listar assets |
wikijs_list_asset_folders |
Listar carpetas de assets |
wikijs_get_current_user |
Usuario actual |
wikijs_search_users |
Buscar usuarios |
Las herramientas de escritura solo se habilitan con
WIKI_MUTATIONS_ENABLED=true.
| Herramienta | Descripción |
|---|---|
wikijs_create_page |
Crear nueva página |
wikijs_update_page |
Actualizar página existente |
wikijs_delete_page |
Eliminar página |
wikijs_move_page |
Mover/renombrar página |
wikijs_restore_page |
Restaurar a versión anterior |
wikijs_create_comment |
Crear comentario |
wikijs_update_comment |
Actualizar comentario |
wikijs_delete_comment |
Eliminar comentario |
wikijs_update_tag |
Actualizar etiqueta |
wikijs_delete_tag |
Eliminar etiqueta |
4 capas de seguridad para prevenir escrituras no intencionadas:
WIKI_MUTATIONS_ENABLED=falseWIKI_MUTATION_CONFIRM_TOKEN requiere valor coincidenteWIKI_ALLOWED_MUTATION_PATH_PREFIXES limita rutas permitidasWIKI_MUTATION_DRY_RUN=true solo devuelve vista previaTodos los intentos de escritura se registran como JSON estructurado en stderr. La información sensible se reemplaza automáticamente con [REDACTED].
Mantenga el token API solo en el servidor. Nunca lo exponga a los clientes.
Para usar este servidor MCP de manera más efectiva, se recomienda crear su propio Skill de Claude Code personalizado.
Una muestra de Skill está disponible en este Gist.