Provides comprehensive tools for managing BookStack wiki content including creating, editing, and organizing books, chapters, pages, and shelves, as well as user management, search functionality, and content export in multiple formats
BookStack MCP Server
Un servidor del MCP que proporciona una interfaz completa para la API de BookStack, permitiendo que modelos de IA generen y editen contenido de la wiki.
Características
Este servidor MCP proporciona herramientas para:
📚 Gestión de Contenido
Libros: Crear, leer, actualizar, eliminar y exportar libros
Capítulos: Gestionar capítulos dentro de libros
Páginas: Crear y editar páginas con contenido HTML o Markdown
Estanterías: Organizar libros en colecciones
🔍 Búsqueda y Descubrimiento
Búsqueda Global: Buscar en todo el contenido de BookStack
Navegación: Explorar la estructura del contenido
👥 Gestión de Usuarios y Permisos
Usuarios: Crear, actualizar y gestionar cuentas de usuario
Roles: Configurar roles y permisos
Autenticación: Soporte para autenticación externa
📎 Recursos Multimedia
Adjuntos: Gestionar archivos adjuntos
Imágenes: Administrar la galería de imágenes
📤 Exportación
Múltiples Formatos: Exportar contenido en HTML, PDF, texto plano y Markdown
Instalación
Prerrequisitos
Node.js 18 o superior
Una instancia de BookStack en funcionamiento
Token de API de BookStack
Configuración
Instalar dependencias:
Configurar variables de entorno:
Compilar el proyecto:
Obtener Tokens de API de BookStack
Inicia sesión en tu instancia de BookStack
Ve a tu perfil de usuario (esquina superior derecha)
Selecciona "Preferencias" → "API Tokens"
Crea un nuevo token con los permisos necesarios
Guarda el Token ID y el Token Secret
Uso
Ejecutar el Servidor
O ejecutar directamente:
Integración con Cliente MCP
El servidor se comunica a través de stdio y está diseñado para ser usado con clientes MCP como Claude Desktop.
Configuración de Claude Desktop
Agrega esta configuración a tu archivo de configuración de Claude Desktop:
Configuración de VS Code
Agrega esta configuración a tu archivo .vscode/mcp.json:
Herramientas Disponibles
Gestión de Libros
list_books
- Listar todos los librosget_book
- Obtener detalles de un libro específicocreate_book
- Crear un nuevo libroupdate_book
- Actualizar un libro existentedelete_book
- Eliminar un libroexport_book
- Exportar libro en varios formatos
Gestión de Capítulos
list_chapters
- Listar capítulosget_chapter
- Obtener detalles de un capítulocreate_chapter
- Crear un nuevo capítuloupdate_chapter
- Actualizar un capítulodelete_chapter
- Eliminar un capítuloexport_chapter
- Exportar capítulo
Gestión de Páginas
list_pages
- Listar páginasget_page
- Obtener contenido de una páginacreate_page
- Crear una nueva páginaupdate_page
- Actualizar contenido de páginadelete_page
- Eliminar una páginaexport_page
- Exportar página
Gestión de Estanterías
list_shelves
- Listar estanteríasget_shelf
- Obtener detalles de una estanteríacreate_shelf
- Crear una nueva estanteríaupdate_shelf
- Actualizar una estanteríadelete_shelf
- Eliminar una estantería
Búsqueda
search_all
- Buscar en todo el contenido
Gestión de Usuarios
list_users
- Listar usuariosget_user
- Obtener detalles de usuariocreate_user
- Crear nuevo usuarioupdate_user
- Actualizar usuariodelete_user
- Eliminar usuario
Gestión de Roles
list_roles
- Listar rolesget_role
- Obtener detalles de rolcreate_role
- Crear nuevo rolupdate_role
- Actualizar roldelete_role
- Eliminar rol
Gestión de Recursos
list_attachments
- Listar adjuntosget_attachment
- Obtener detalles de adjuntodelete_attachment
- Eliminar adjuntolist_images
- Listar imágenesget_image
- Obtener detalles de imagenupdate_image
- Actualizar imagendelete_image
- Eliminar imagen
Ejemplos de Uso
Crear un Nuevo Libro
Crear una Página con Contenido
Buscar Contenido
Seguridad
Todas las operaciones requieren un token de API válido de BookStack
Los permisos se manejan a través del sistema de roles de BookStack
Las validaciones de entrada utilizan schemas Zod para mayor seguridad
Manejo robusto de errores para evitar exposición de información sensible
Desarrollo
Estructura del Proyecto
Scripts Disponibles
npm run build
- Compilar TypeScript a JavaScriptnpm run dev
- Ejecutar en modo desarrollo con watchnpm start
- Ejecutar el servidor compiladonpm test
- Ejecutar tests (si están configurados)
Contribuir
Fork el proyecto
Crea una rama para tu feature (
git checkout -b feature/nueva-funcionalidad
)Commit tus cambios (
git commit -am 'Agregar nueva funcionalidad'
)Push a la rama (
git push origin feature/nueva-funcionalidad
)Crea un Pull Request
Licencia
Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE
para más detalles.
Soporte
Para problemas y preguntas:
Verifica la documentación de la API de BookStack
Revisa los logs de error del servidor MCP
Crea un issue en el repositorio del proyecto
Changelog
v1.0.0
Implementación inicial del servidor MCP
Soporte completo para la API de BookStack
Herramientas para gestión de contenido, usuarios y búsqueda
Validación robusta con Zod
Exportación en múltiples formatos
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Enables AI models to interact with BookStack wiki instances through a comprehensive API interface. Supports content management (books, chapters, pages), user administration, search functionality, and content export in multiple formats.
Related MCP Servers
- AsecurityAlicenseAqualityAllows AI models to interact with SourceSync.ai's knowledge management platform to organize, ingest, retrieve, and search content in knowledge bases.Last updated -25153MIT License
- -securityFlicense-qualityA tool that enables AI assistants like Claude to interact with MediaWiki instances by retrieving page content, performing searches, and analyzing wiki information through the MediaWiki API.
- AsecurityAlicenseAqualityEnables AI assistants to search and retrieve content from WikiJS knowledge bases, allowing integration with your Wiki through simple search and retrieval tools.Last updated -4141MIT License
- -securityFlicense-qualityA production-ready server that provides Wikipedia search and content retrieval tools through the Model Context Protocol, enabling AI assistants to search for articles, list sections, and retrieve specific content.Last updated -