MCP Atlassian

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 Atlassian products (Confluence and Jira) through a standardized interface

  • Allows searching content, getting spaces, retrieving content, and listing pages in Confluence

  • Enables searching issues, getting issue details, listing projects, and more in Jira

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

# Using npm npm start # Using make make start # Using Docker make docker-run

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

src/ ├── config/ # Configuration files ├── examples/ # Example usage ├── services/ # Service classes for Atlassian APIs │ ├── confluence.ts │ └── jira.ts ├── tools/ # MCP tools │ ├── search-confluence.ts │ ├── get-confluence-space.ts │ ├── get-confluence-content.ts │ ├── get-confluence-pages.ts │ ├── search-jira-issues.ts │ ├── get-jira-issue.ts │ ├── get-jira-projects.ts │ ├── get-jira-project.ts │ ├── get-jira-issue-types.ts │ ├── utils.ts │ └── index.ts └── index.ts # Main entry point

Edificio

# Using npm npm run build # Using make make build

Pruebas

# Using npm npm test # Using make make test

Comandos de Makefile

El proyecto incluye un Makefile para simplificar las operaciones comunes:

# Display available commands make help

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
-
security - not tested
F
license - not found
-
quality - not tested

Un servidor MCP que permite a los agentes de IA interactuar con los productos Atlassian (Confluence y Jira) para la gestión de contenido, seguimiento de problemas y gestión de proyectos a través de una interfaz estandarizada.

  1. Overview
    1. Prerequisites
      1. Installation
        1. Standard Installation
        2. Docker Installation
      2. Usage
        1. Starting the Server
        2. Available Tools
      3. Development
        1. Project Structure
        2. Building
        3. Testing
        4. Makefile Commands
      4. License
        1. Contributing
          ID: w8drdld8a6