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
- 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 :
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 :
Desarrollo
Configuración
Configure las variables de entorno antes de ejecutar el servidor. Cree un archivo .env
en el directorio raíz:
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 :
Instalación manual
- Clonar este repositorio:
- Instalar dependencias:
Ejecutando con MCP Inspector
Para pruebas y desarrollo, puede utilizar el Inspector MCP:
Agregar nuevas herramientas
Para agregar nuevas herramientas, modifique el controlador ListToolsRequestSchema
en index.js
:
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.
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.
Tools
Proporciona capacidades para buscar problemas de Jira usando JQL y recuperar información detallada del problema.
Related MCP Servers
- AsecurityFlicenseAqualityProvides integration with Jira's REST API, allowing AI assistants to manage Jira issues programmatically.Last updated -66JavaScript
- -securityFlicense-qualityEnables 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 -2TypeScript
- -securityFlicense-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 -Python
- AsecurityAlicenseAqualityA 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 -1120JavaScriptMIT License