Servidor MCP de Confluence

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con Confluence Data Center mediante la API REST. Este servidor proporciona un conjunto de herramientas que permiten a los modelos de IA interactuar con el contenido de Confluence.

Características

Este servidor MCP proporciona las siguientes operaciones para Confluence:

• Ejecutar búsquedas CQL (Confluence Query Language)

• Obtener el contenido de la página por ID

• Obtener el contenido de la página con el cuerpo

• Buscar páginas con la tecla espaciadora

• Buscar página por título y tecla espacio

• Crear nuevas páginas (con página principal opcional)

• Actualizar páginas existentes

• Eliminar páginas

Related MCP server: Confluence MCP Server

Instalación

1. Clonar este repositorio

2. Instalar dependencias:

pip install -r requirements.txt

Configuración

Cree un archivo .env en la raíz del proyecto con las siguientes variables:

CONFLUENCE_API_BASE=http://localhost:8090/rest/api
CONFLUENCE_USERNAME=your_username
CONFLUENCE_PASSWORD=your_password

Ajuste los valores para que coincidan con su instancia de Confluence.

Ejecución del servidor

Modo de desarrollo (recomendado)

La forma correcta de ejecutar un servidor MCP es mediante la herramienta CLI de MCP en modo de desarrollo. Esto iniciará la interfaz de usuario del Inspector de MCP, que permite probar y depurar el servidor.

mcp dev confluence.py

Esto iniciará el Inspector MCP en http://127.0.0.1:6274 de forma predeterminada.

Ejecución directa (no recomendada)

Los servidores MCP están diseñados para ejecutarse con la herramienta CLI de MCP o integrarse con Claude Desktop. La ejecución directa con Python no es la forma estándar de ejecutar un servidor MCP, pero el script incluye un modo de respaldo para realizar pruebas:

python confluence.py

Sin embargo, este modo tiene una funcionalidad limitada y solo está destinado a pruebas básicas.

Instalación en Claude Desktop

Para instalar el servidor en Claude Desktop:

mcp install confluence.py

Referencia de API

ejecutar_cql_search

Ejecute una consulta CQL en Confluence para buscar páginas.

Parámetros:

• cql : cadena de consulta CQL

• limit : Número de resultados a devolver (predeterminado: 10)

obtener_contenido_de_la_página

Obtener el contenido de una página de Confluence.

Parámetros:

• pageId : ID de página de Confluence

obtener_página_con_cuerpo

Obtenga una página con su contenido principal.

Parámetros:

• pageId : ID de página de Confluence

buscar_páginas_por_espacio

Buscar páginas mediante la tecla espaciadora.

Parámetros:

• spaceKey : Clave espacial de confluencia

• limit : Número máximo de resultados a devolver (predeterminado: 10)

• expand : Lista opcional de propiedades separadas por comas para expandir

buscar página por título

Busque una página por título y tecla espaciadora.

Parámetros:

• title : Título de la página

• spaceKey : Clave espacial de confluencia

crear_página

Crear una nueva página en Confluence.

Parámetros:

• title : Título de la página

• spaceKey : Clave espacial de confluencia

• content : Contenido de la página en formato de almacenamiento (HTML)

• parentId : ID de la página principal opcional

página de actualización

Actualizar una página existente en Confluence.

Parámetros:

• pageId : ID de página de Confluence

• content : Nuevo contenido de página en formato de almacenamiento (HTML)

• title : Nuevo título opcional para la página

• spaceKey : tecla espaciadora opcional (solo es necesaria si se cambia el espacio)

eliminar_página

Eliminar una página por ID.

Parámetros:

• pageId : ID de página de Confluence

Ejemplo de uso

Una vez que el servidor esté en funcionamiento y conectado a un modelo de IA, podrá interactuar con Confluence mediante lenguaje natural. Por ejemplo:

• "Buscar todas las páginas en el espacio DOCS"

• Obtener el contenido de la página con ID 123456

• Crear una nueva página titulada "Notas de la reunión" en el espacio EQUIPO con el contenido "Notas de nuestra reunión".

• Actualizar la página con el ID 123456 para incluir el contenido "Notas de reunión actualizadas".

• Actualizar el título de la página 123456 a 'Notas de la reunión revisadas'.

Licencia

Instituto Tecnológico de Massachusetts (MIT)