Jira MCP

Servidor MCP de Jira para buscar incidencias, leer datos de proyectos y conectar flujos de trabajo de Jira con asistentes de IA compatibles con MCP.

GitHub

Prueba este MCPPatrocinado

Documentación

hh-jira-mcp-server MCP server

Un proyecto de servidor MCP

Inicio rápido

Regístrate en https://claude.ai y compra la suscripción Pro

Instalación

Instala Claude Desktop https://claude.ai/download

Instala uv:

brew install uv

Instala keyring: https://pypi.org/project/keyring/

Almacena la contraseña para la cuenta de Jira

keyring set hh-jira-mcp-server v.pupkin

Claude Desktop

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

Configuración de servidores publicados

{
  "mcpServers": {
    "hh-jira-mcp-server": {
      "command": "uvx",
      "args": [
        "hh-jira-mcp-server"
      ],
      "env": {
        "HH_JIRA_MCP_USER": "v.pupkin",
        "HH_JIRA_MCP_TEAM": "some-team",
        "HH_JIRA_MCP_SEARCH_FILTER": "status in (\"Development: In progress\")"
      }
    }
  }
}

Configuración de servidores de desarrollo/no publicados

{
  "mcpServers": {
    "hh-jira-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "<path_to_project>/hh-jira-mcp-server",
        "run",
        "hh-jira-mcp-server"
      ],
      "env": {
        "HH_JIRA_MCP_USER": "v.pupkin",
        "HH_JIRA_MCP_TEAM": "some-team",
        "HH_JIRA_MCP_SEARCH_FILTER": "status in (\"Development: In progress\")"
      }
    }
  }
}

Desarrollo

Compilación y publicación

Para preparar el paquete para su distribución:

Sincroniza las dependencias y actualiza el archivo de bloqueo:

uv sync

Compila las distribuciones del paquete:

uv build

Esto creará distribuciones de código fuente y wheel en el directorio dist/.

Publica en PyPI:

uv publish

Nota: Necesitarás configurar las credenciales de PyPI mediante variables de entorno o banderas de comando:

Token: --token o UV_PUBLISH_TOKEN
O nombre de usuario/contraseña: --username/UV_PUBLISH_USERNAME y --password/UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan sobre stdio, la depuración puede ser desafiante. Para la mejor experiencia de depuración, recomendamos encarecidamente usar el MCP Inspector.

Puedes lanzar el MCP Inspector mediante npm con este comando:

npx @modelcontextprotocol/inspector uv --directory <path_to_project>/hh-jira-mcp-server run hh-jira-mcp-server

Al lanzarlo, el Inspector mostrará una URL que podrás acceder en tu navegador para comenzar a depurar.