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

Related MCP server: Confluence MCP

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)