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 Server

Configuración

Opción 1: Usar Docker (recomendado)

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

docker run --rm -i \
  -e CONFLUENCE_API_TOKEN=your-api-token \
  -e CONFLUENCE_EMAIL=your-email@domain.com \
  -e CONFLUENCE_DOMAIN=your-domain.atlassian.net \
  ghcr.io/aaronsb/confluence-cloud-mcp:latest

Opción 2: Construir localmente

1. Clonar el repositorio:

git clone https://github.com/aaronsb/confluence-cloud-mcp.git
cd confluence-cloud-mcp

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

# Build the Docker image
./scripts/build-local.sh

# Run the server
CONFLUENCE_API_TOKEN=your-token CONFLUENCE_EMAIL=your-email ./scripts/run-local.sh

Opción 3: Desde la fuente

1. Instalar dependencias:

npm install

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

CONFLUENCE_DOMAIN=your-domain.atlassian.net
CONFLUENCE_EMAIL=your-email@domain.com
CONFLUENCE_API_TOKEN=your-api-token

3. Construir el proyecto:

npm run build

4. Ejecutar el servidor:

node build/index.js

Uso

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

{
  "mcpServers": {
    "confluence": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/aaronsb/confluence-cloud-mcp:latest"],
      "env": {
        "CONFLUENCE_DOMAIN": "your-domain.atlassian.net",
        "CONFLUENCE_EMAIL": "your-email@domain.com",
        "CONFLUENCE_API_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

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)