Confluence MCP Server

Servidor MCP de Confluence Cloud

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para interactuar con Confluence Cloud. Este servidor permite a los asistentes de IA gestionar espacios, páginas y contenido de Confluence mediante una interfaz estandarizada.

Características

• Gestión del espacio
  • Lista de espacios
  • Obtener detalles del espacio
• Operaciones de página
  • Crear, leer, actualizar páginas
  • Listar páginas en un espacio
  • Convertir el contenido de la página del formato de almacenamiento de Confluence a Markdown
• Búsqueda y etiquetas
  • Buscar contenido usando CQL
  • Administrar etiquetas de página

Configuración

Opción 1: Usar Docker (recomendado)

La forma más sencilla de utilizar este servidor es con la imagen de Docker preconstruida:

Opción 2: Construir localmente

1. Clonar el repositorio:

2. Construya y ejecute utilizando el script de compilación local:

Opción 3: Desde la fuente

1. Instalar dependencias:

2. Configurar variables de entorno: Cree un archivo .env con sus credenciales de Confluence:

3. Construir el proyecto:

4. Ejecutar el servidor:

Uso

El servidor se puede integrar con asistentes de IA compatibles con MCP agregándolo a su configuración de MCP:

Nota para asistentes de IA : si eres un asistente de IA como Cline y estás intentando instalar este servidor MCP, consulta el archivo llms-install.md para obtener instrucciones de instalación detalladas.

Herramientas disponibles

Herramientas espaciales

• list_confluence_spaces : Lista todos los espacios en Confluence
• get_confluence_space : Obtener detalles sobre un espacio específico

Herramientas de página

• list_confluence_pages : Listar páginas en un espacio
• get_confluence_page : Obtener una página específica con su contenido (ahora incluye conversión de Markdown)
• create_confluence_page : Crea una nueva página en un espacio
• update_confluence_page : Actualizar una página existente

La herramienta get_confluence_page ahora convierte automáticamente el contenido del formato de almacenamiento Confluence a Markdown, lo que facilita el trabajo con el contenido de la página. La conversión gestiona:

• Encabezados (h1-h6)
• Listas (ordenadas y desordenadas)
• Campo de golf
• Énfasis (negrita/cursiva)
• Bloques de código
• Tablas
• Párrafos y saltos de línea

Herramientas de búsqueda y etiquetado

• search_confluence_pages : Busca contenido de Confluence usando CQL
• get_confluence_labels : Obtener etiquetas para una página
• add_confluence_label : Agregar una etiqueta a una página
• remove_confluence_label : Eliminar una etiqueta de una página

Nota : Todos los nombres de herramientas siguen la convención de nomenclatura [verbo] confluencia [sustantivo] para lograr coherencia y claridad.

Desarrollo

Este proyecto está escrito en TypeScript y sigue las convenciones del SDK de MCP para implementar las funciones del servidor. El código base se organiza en:

• src/client/ - Implementación del cliente de la API de Confluence
• src/handlers/ - Controladores de solicitudes de herramientas MCP
• src/schemas/ - Esquemas JSON para entradas de herramientas
• src/types/ - Definiciones de tipos de TypeScript
• src/utils/ - Funciones de utilidad que incluyen conversión de formato de contenido

Canalización de CI/CD

Este proyecto utiliza GitHub Actions para la integración y la implementación continuas:

• Pruebas automatizadas y análisis de errores en solicitudes de extracción
• Compilaciones automáticas de imágenes de Docker en las confirmaciones de la rama principal
• Compilaciones de imágenes multiarquitectura (amd64, arm64)
• Publicación de contenedores en GitHub Container Registry

Desarrollo local

Para el desarrollo local, utilice los scripts proporcionados:

• ./scripts/build-local.sh : compila el proyecto y crea una imagen de Docker local
• ./scripts/run-local.sh : ejecuta la imagen local de Docker con sus credenciales

Licencia

Instituto Tecnológico de Massachusetts (MIT)