Skip to main content
Glama

jira-mcp

by CamdenClark

Servidor JIRA MCP

Un servidor MCP que permite que los Modelos de Lenguaje Grandes (LLM) interactúen con JIRA mediante herramientas y contexto estandarizados. Este servidor ofrece funciones para buscar incidencias mediante JQL y recuperar información detallada sobre ellas.

Características

  • Búsqueda JQL : Ejecute consultas JQL complejas con soporte de paginación
  • Detalles del problema : recupera información detallada sobre problemas específicos de JIRA

Prerrequisitos

  • npm instalado
  • Una instancia de JIRA con acceso a API
  • Token de API de JIRA o token de acceso personal
  • Correo electrónico del usuario de JIRA asociado con el token de API

Obtención de credenciales de API de JIRA

  1. Inicie sesión en su cuenta de Atlassian en https://id.atlassian.com
  2. Vaya a Configuración de seguridad
  3. En Tokens de API, seleccione "Crear token de API".
  4. Dale a tu token un nombre significativo (por ejemplo, "Servidor MCP")
  5. Copia el token generado: ¡no podrás volver a verlo!
  6. Utilice este token como su JIRA_API_KEY
  7. Utilice la dirección de correo electrónico asociada a su cuenta Atlassian como JIRA_USER_EMAIL

Uso

Integración con Claude Desktop

  1. Agregue la configuración del servidor al archivo de configuración de Claude Desktop:

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "jira": { "command": "npx", "args": ["-y", "jira-mcp"], "env": { "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net", "JIRA_USER_EMAIL": "your-email@company.com", "JIRA_API_KEY": "your-api-token" } } } }
  1. Reinicie Claude Desktop para cargar la nueva configuración.

Herramientas disponibles

Ejecuta una consulta de búsqueda JQL con parámetros personalizables.

Parámetros :

  • jql (obligatorio): cadena de consulta JQL
  • nextPageToken : Token para paginación
  • maxResults : Número máximo de resultados a devolver
  • fields : Matriz de nombres de campos a incluir
  • expand : Información adicional para incluir

Ejemplo :

{ "jql": "project = 'MyProject' AND status = 'In Progress'", "maxResults": 10, "fields": ["summary", "status", "assignee"] }

2. Obtener problema ( get_issue )

Recupera información detallada sobre un problema específico.

Parámetros :

  • issueIdOrKey (obligatorio): ID del problema o clave
  • fields : Matriz de nombres de campos a incluir
  • expand : Información adicional para incluir
  • properties : Matriz de propiedades a incluir
  • failFast : si se debe fallar rápidamente ante errores

Ejemplo :

{ "issueIdOrKey": "PROJ-123", "fields": ["summary", "description", "status"], "expand": "renderedFields,names" }

Desarrollo

Configuración

Configure las variables de entorno antes de ejecutar el servidor. Cree un archivo .env en el directorio raíz:

JIRA_INSTANCE_URL=https://your-instance.atlassian.net JIRA_USER_EMAIL=your-email@company.com JIRA_API_KEY=your-api-token

Reemplace los valores con:

  • La URL real de su instancia de JIRA
  • La dirección de correo electrónico asociada a su cuenta de JIRA
  • Su token de API de JIRA (se puede generar en la configuración de la cuenta de Atlassian)

Instalación

Instalación mediante herrería

Para instalar JIRA para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install jira-mcp --client claude

Instalación manual

  1. Clonar este repositorio:
git clone <repository-url> cd jira-mcp
  1. Instalar dependencias:
npm install

Ejecutando con MCP Inspector

Para pruebas y desarrollo, puede utilizar el Inspector MCP:

npm run inspect

Agregar nuevas herramientas

Para agregar nuevas herramientas, modifique el controlador ListToolsRequestSchema en index.js :

server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools: [ // Existing tools... { name: "your_new_tool", description: "Description of your new tool", inputSchema: { // Define input schema... } } ] }; });

Luego implemente la herramienta en el controlador CallToolRequestSchema .

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar un PR.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

Proporciona capacidades para buscar problemas de Jira usando JQL y recuperar información detallada del problema.

  1. Características
    1. Prerrequisitos
      1. Obtención de credenciales de API de JIRA
    2. Uso
      1. Integración con Claude Desktop
    3. Herramientas disponibles
      1. Búsqueda JQL ( jql_search )
      2. Obtener problema ( get_issue )
    4. Desarrollo
      1. Configuración
      2. Instalación
      3. Instalación mediante herrería
      4. Instalación manual
      5. Ejecutando con MCP Inspector
      6. Agregar nuevas herramientas
    5. Licencia
      1. Contribuyendo

        Related MCP Servers

        • A
          security
          F
          license
          A
          quality
          Provides integration with Jira's REST API, allowing AI assistants to manage Jira issues programmatically.
          Last updated -
          6
          6
          JavaScript
          • Apple
        • -
          security
          F
          license
          -
          quality
          Enables AI models to interact with Jira using a standardized protocol, offering full Jira REST API integration with features like optimal performance through connection pooling, error handling, and request monitoring.
          Last updated -
          2
          TypeScript
        • -
          security
          F
          license
          -
          quality
          A server implementation that allows AI models to interact with Jira through the Model Context Protocol, enabling tasks like JQL searches and retrieving issue details.
          Last updated -
          Python
        • A
          security
          A
          license
          A
          quality
          A TypeScript-based server that enables interaction with Jira, providing tools to execute JQL queries, manage tickets, list projects and statuses through natural language.
          Last updated -
          11
          20
          JavaScript
          MIT License
          • Apple

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/CamdenClark/jira-mcp'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server