WikiJS

Servidor MCP de WikiJS

Un servidor de Model Context Protocol (MCP) que proporciona integración con WikiJS, permitiendo a los asistentes de IA buscar y recuperar contenido de tu base de conocimientos de WikiJS.

Descripción general

Este servidor MCP permite a los asistentes de IA interactuar con instancias de WikiJS proporcionando herramientas para:

• Buscar páginas por cadena de consulta
• Recuperar páginas por ID
• Recuperar páginas por ruta y configuración regional
• Obtener todas las páginas de la wiki

Configuración para Cursor

Stdio

{
  "mcpServers": {
    "wikijs-mcp": {
      "command": "npx",
        "args": [
            "wikijs-mcp"
        ],
        "env": {
            "WIKIJS_URL": <your wikijs url>,
            "WIKIJS_API_KEY": <your wikijs api key>
        }
    }
  }
}

Streamable Http

Máquina anfitriona

Inicia el servidor TRANSPORT_METHOD=streamable-http TRANSPORT_OPTIONS_PORT=8080 npx wikijs-mcp (Consulta Variables de entorno para todas las variables disponibles)

IDE

{
  "mcpServers": {
    "wikijs-mcp": {
      "transport": "http-streamable",
      "name": "WikiJS MCP",
      "url": <your mcp host url with port>/mcp
    }
  }
}

Cómo obtener una clave API de WikiJS

1. Inicia sesión en tu instancia de WikiJS como administrador
2. Ve a Administración > Acceso API
3. Crea una nueva clave API con los permisos adecuados
4. Copia la clave generada a tu archivo .env

Desarrollo

1. Clona el repositorio:

git clone https://github.com/RicardoCenci/wikijs-mcp.git
cd wikijs-mcp

2. Instala las dependencias:

npm install

3. Copia la plantilla de entorno y completa su contenido

cp env.example .env

4. Compila el proyecto Si tienes make instalado:

make build

5. Implementa la instancia de WikiJS para pruebas

docker compose up -d

Uso

npx wikijs-mcp

Variables de entorno

Variable	Descripción	Requerida	Valores permitidos	Predeterminado
WIKIJS_URL	URL de tu instancia de WikiJS	Sí	-	-
WIKIJS_API_KEY	Clave API de WikiJS	Sí	-	-
TRANSPORT_METHOD	El método de transporte	No	stdio, streamable-http	stdio
TRANSPORT_OPTIONS_CORS_ORIGIN	Origen CORS (solo en streamable-http)	No	-	*
TRANSPORT_OPTIONS_CORS_HEADERS	Cabeceras CORS, separadas por comas (solo en streamable-http)	No	-	Content-Type=mcp-session-id
TRANSPORT_OPTIONS_CORS_METHODS	Métodos CORS, separados por comas (solo en streamable-http)	No	-	GET,POST,OPTIONS
TRANSPORT_OPTIONS_SESSION_TIMEOUT_MS	Tiempo de espera de sesión (solo en streamable-http)	No	-	60000

Licencia

Este proyecto está licenciado bajo la Licencia MIT.