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

Allows interaction with JIRA through JQL search queries and retrieving detailed issue information

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

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

Uso

Integración con Claude Desktop

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"
      }
    }
  }
}

Reinicie Claude Desktop para cargar la nueva configuración.

Herramientas disponibles

1. Búsqueda JQL ( `jql_search` )

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

Clonar este repositorio:

git clone <repository-url>
cd jira-mcp

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

Tools

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