MCP Atlassian

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para interactuar con los productos de Atlassian (Confluence y Jira).

Descripción general

Este servidor MCP permite a los agentes de IA interactuar con los productos de Atlassian a través de una interfaz estandarizada. Proporciona herramientas para:

• Confluence : busca contenido, obtén espacios, recupera contenido y enumera páginas

• Jira : buscar problemas, obtener detalles de problemas, enumerar proyectos y más

Prerrequisitos

• Node.js (v16 o superior)

• npm o hilo

• Cuenta Atlassian con token API

• Docker (opcional, para implementación en contenedores)

Instalación

Instalación estándar

1. Clonar el repositorio:

   git clone https://github.com/yourusername/mcp-atlassian.git cd mcp-atlassian

2. Instalar dependencias:

   npm install # or using make make install

3. Cree un archivo .env en el directorio raíz con sus credenciales de Atlassian:

   ATLASSIAN_HOST=https://your-domain.atlassian.net ATLASSIAN_EMAIL=your-email@example.com ATLASSIAN_API_TOKEN=your-api-token

Instalación de Docker

1. Clonar el repositorio:

   git clone https://github.com/yourusername/mcp-atlassian.git cd mcp-atlassian

2. Cree un archivo .env como se describe arriba.

3. Construya y ejecute el contenedor Docker:

   # Build the Docker image make docker-build # Run the Docker container make docker-run # Or use Docker Compose make docker-compose

Uso

Iniciando el servidor

Esto iniciará el servidor MCP, que escuchará las solicitudes en la entrada estándar y responderá en la salida estándar.

Herramientas disponibles

Herramientas de Confluence

• search-confluence : Busca contenido en Confluence usando CQL

  • Parámetros: query (cadena)

• get-confluence-space : obtener información sobre un espacio de Confluence específico

  • Parámetros: spaceKey (cadena)

• get-confluence-content : Obtener contenido específico por ID

  • Parámetros: contentId (cadena)

• get-confluence-pages : Obtener todas las páginas de un espacio

  • Parámetros: spaceKey (cadena), limit (número, opcional)

Herramientas de Jira

• search-jira-issues : Buscar problemas usando JQL

  • Parámetros: jql (cadena), maxResults (número, opcional)

• get-jira-issue : Obtener un problema específico por clave

  • Parámetros: issueKey (cadena)

• get-jira-projects : Obtener todos los proyectos

  • Parámetros: ninguno

• get-jira-project : Obtener un proyecto específico por clave

  • Parámetros: projectKey (cadena)

• get-jira-issue-types : Obtener todos los tipos de problemas

  • Parámetros: ninguno

Desarrollo

Estructura del proyecto

Edificio

Pruebas

Comandos de Makefile

El proyecto incluye un Makefile para simplificar las operaciones comunes:

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuyendo

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción