Servidor MCP de Wiki.js

Servidor del Protocolo de Contexto de Modelo para integración con Wiki.js - Crea y gestiona páginas wiki directamente desde tu asistente de IA.

¿Usando esto desde Claude Code? Usa wikijs-plugin en su lugar — combina este servidor (portado a Python) con una habilidad docs-wiki en un solo plugin instalable mediante el mecanismo de marketplace de Claude Code, sin necesidad de pasos manuales de clonación/compilación/configuración. La configuración pasa del .env de este repositorio a ~/.wikijs-plugin/.env (configurado mediante /wikijs-plugin:setup); el tiempo de ejecución cambia de Node.js 18+ a Python 3.11+; los nombres de las herramientas (wikijs_create_page, ...) no cambian. Este repositorio continúa recibiendo correcciones y sigue siendo la forma de ejecutar el servidor directamente (consulta Inicio Rápido a continuación) para cualquier cliente MCP que no sea Claude Code.

Migrando una instalación existente: copia ~/.claude/mcp-servers/wikijs/.env a ~/.wikijs-plugin/.env (mismas claves, mismos valores — no se necesita un nuevo token de API), luego elimina la entrada antigua wikijs de ~/.claude.json para que las herramientas no se registren dos veces.

v2.0.0 - Reestructuración Mayor

Esta versión incluye una reescritura completa siguiendo las Mejores Prácticas de MCP:

• TypeScript - Seguridad de tipos total con modo estricto

• SDK moderno - Utiliza MCP SDK v1.24+ con la API McpServer.tool()

• Validación Zod - Validación de entrada en tiempo de ejecución para todas las herramientas

• Herramientas con Prefijo de Servicio - Todas las herramientas usan el prefijo wikijs_ para claridad en el espacio de nombres

• Anotaciones de Herramientas - readOnlyHint, destructiveHint, etc. adecuados

• Soporte de Paginación - Las operaciones de listado devuelven has_more, next_offset, total_count

• Límites de Caracteres - El contenido grande se trunca con avisos claros

Related MCP server: mediawiki-mcp-server

Documentación

Documentación completa y preguntas frecuentes

La guía completa incluye:

• Instrucciones de instalación

• Ejemplos de configuración

• Las 7 herramientas MCP con parámetros

• Detalles de integración con la API GraphQL

• Guía de solución de problemas

Inicio Rápido

Para cualquier cliente MCP que no sea Claude Code (consulta la nota anterior para Claude Code):

# 1. Clone repository
git clone https://github.com/markus-michalski/wikijs-mcp-server.git
cd wikijs-mcp-server

# 2. Install dependencies
npm install

# 3. Build TypeScript
npm run build

# 4. Configure environment
cp .env.example .env
# Edit .env with your Wiki.js API credentials

# 5. Point your MCP client's config at dist/index.js and restart it

Requisitos

• Node.js 18+

• Instancia de Wiki.js (v2.x o v3.x)

• Token de API de Wiki.js con permisos de gestión de páginas

Herramientas Disponibles

Desarrollo

# Development with hot-reload
npm run dev

# Build for production
npm run build

# Type checking
npm run typecheck

Estructura del Proyecto

wikijs-mcp-server/
├── src/
│   ├── index.ts           # Main server entry point
│   ├── constants.ts       # Shared constants (CHARACTER_LIMIT, etc.)
│   ├── types.ts           # TypeScript type definitions
│   ├── schemas/           # Zod validation schemas
│   ├── services/          # API client and error handling
│   └── tools/             # Tool implementations
├── dist/                  # Compiled JavaScript
├── evaluation.xml         # MCP evaluation test questions
└── package.json

Licencia

Licencia MIT - Consulta LICENSE para más detalles

Autor

Markus Michalski

• Sitio web: markus-michalski.net

• GitHub: @markus-michalski

Enlaces

• Documentación completa (Inglés)

• Documentación completa (Alemán)

• Registro de cambios