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.

Integrations

Provides tools for interacting with Confluence Cloud, enabling management of spaces, pages, and content through features like listing spaces, creating/reading/updating pages, converting Confluence storage format to Markdown, searching content using CQL, and managing page labels.

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:

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

Clonar el repositorio:

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

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

Instalar dependencias:

npm install

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

Construir el proyecto:

npm run build

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)

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Permite que los asistentes de IA interactúen con Confluence Cloud para administrar espacios, páginas y contenido a través del Protocolo de contexto de modelo (MCP).

Related Resources

Reddit Discussion about this server

Confluence MCP Server