Servidor MCP de Atlassian

Un servidor de Protocolo de Contexto de Modelo (MCP) para la integración con Atlassian JIRA y Confluence. Este servidor proporciona herramientas para interactuar con tickets de JIRA y páginas de Confluence mediante el protocolo MCP.

Características

• Obtenga los detalles del ticket de JIRA
• Búsqueda de tickets de JIRA mediante JQL
• Crear nuevos tickets de JIRA
• Agregar comentarios a los tickets de JIRA
• Obtener el contenido de la página de Confluence
• Buscar contenido en Confluence

Prerrequisitos

• Node.js 16 o superior
• Una cuenta de Atlassian Cloud
• Un token de API de Atlassian

Instalación

Opción 1: Instalar desde Cline Marketplace (recomendado)

1. Cline abierto
2. Vaya a Configuración > Servidores MCP
3. Seleccione la pestaña "Mercado"
4. Buscar "Atlassian"
5. Haga clic en "Instalar"
6. Configure sus credenciales de Atlassian cuando se le solicite

Opción 2: Instalar desde npm

Opción 3: Instalar desde la fuente

1. Clonar el repositorio
2. Ejecute el script de instalación:

O manualmente:

1. Instalar dependencias

2. Construir el proyecto

3. Instalar globalmente

4. Ejecutar la configuración

Configuración

Puede configurar el servidor utilizando el script de instalación, un archivo de configuración o variables de entorno.

Usando el script de configuración (recomendado)

Ejecute el script de instalación para crear su archivo de configuración:

O si se instala localmente:

El script lo guiará a través del proceso de configuración y creará un archivo config.json en el directorio config .

Usar un archivo de configuración manualmente

1. Crea un archivo config.json en el directorio config (puedes copiarlo desde config.sample.json )
2. Complete sus datos de Atlassian:

Uso de variables de entorno

Establezca las siguientes variables de entorno:

• ATLASSIAN_BASE_URL : la URL de su instancia de Atlassian (por ejemplo, https://your-instance.atlassian.net )
• ATLASSIAN_EMAIL : El correo electrónico de su cuenta Atlassian
• ATLASSIAN_TOKEN : Su token de API de Atlassian
• ATLASSIAN_CONFIG_PATH : (opcional) Ruta a la ubicación de un archivo de configuración personalizado

Obtener un token de API de Atlassian

1. Inicie sesión en su cuenta de Atlassian en https://id.atlassian.com/manage-profile/security/api-tokens
2. Haga clic en "Crear token de API".
3. Dale un nombre a tu token (por ejemplo, "Servidor MCP")
4. Copia el token generado (no podrás volver a verlo)

Uso

Ejecutando el servidor

O si se instala desde la fuente:

Integración con Cline

Opción 1: Instalar desde Marketplace (recomendado)

1. Cline abierto
2. Vaya a Configuración > Servidores MCP
3. Seleccione la pestaña "Mercado"
4. Buscar "Atlassian"
5. Haga clic en "Instalar"
6. Configure sus credenciales de Atlassian cuando se le solicite

Opción 2: Configuración manual

Si ha instalado el servidor manualmente, agregue lo siguiente a la configuración de MCP:

Alternativamente, puede proporcionar las credenciales directamente en la configuración:

Herramientas disponibles

obtener_ticket_jira

Obtener detalles de un ticket de JIRA por clave.

Parámetros:

• ticket_key : clave de ticket JIRA (p. ej., "PROJ-123")

búsqueda_de_tickets_jira

Busque tickets de JIRA usando JQL.

Parámetros:

• jql : cadena de consulta JQL
• max_results : Número máximo de resultados a devolver (predeterminado: 10)

crear_ticket_jira

Crear un nuevo ticket de JIRA.

Parámetros:

• project_key : Clave del proyecto (p. ej., "PROJ")
• summary : Resumen/título del ticket
• description : Descripción del ticket
• issue_type : Tipo de problema (p. ej., "Error", "Tarea", "Historia") (predeterminado: "Tarea")

añadir_comentario_al_ticket_de_jira

Agregar un comentario a un ticket de JIRA.

Parámetros:

• ticket_key : clave de ticket JIRA (p. ej., "PROJ-123")
• comment : Texto del comentario

obtener_página_de_confluencia

Obtener una página de Confluence por ID.

Parámetros:

• page_id : ID de la página de Confluence

búsqueda_confluencia

Buscar contenido en Confluence.

Parámetros:

• query : Consulta de búsqueda
• limit : Número máximo de resultados (predeterminado: 10)

Publicación en el Marketplace

Este servidor está configurado para publicarse en Cline MCP Marketplace mediante el repositorio de GitHub en: https://github.com/kompallik/ATLASSIAN-MCP

Para publicar actualizaciones:

1. Envíe sus cambios al repositorio de GitHub utilizando el script proporcionado:

2. Agregue un archivo icon.png en el directorio assets si aún no está presente
3. Ejecute el script de publicación:

4. Siga las instrucciones para publicar en npm y/o crear un paquete de distribución
5. Envíe la URL de su repositorio al equipo de Cline MCP Marketplace

Licencia

Instituto Tecnológico de Massachusetts (MIT)