A
security-
licenseA
qualityProvides integration with Jira's REST API, allowing AI assistants to manage Jira issues programmatically.
Last updated -
8
9
MIT License
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
npminstaladoUna 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_KEYUtilice 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 JQLnextPageToken: Token para paginaciónmaxResults: Número máximo de resultados a devolverfields: Matriz de nombres de campos a incluirexpand: 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 clavefields: Matriz de nombres de campos a incluirexpand: Información adicional para incluirproperties: Matriz de propiedades a incluirfailFast: 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.
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.
Related MCP Servers
- -security-license-qualityA 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 -
- Asecurity-licenseAqualityA 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 -1124MIT License
- -security-license-qualityA collection of tools for interacting with Jira via the Model Context Protocol, providing core functionalities like fetching and analyzing issues, plus a guided Issue Creation Wizard.Last updated -522MIT License