Jira Server MCP

Servidor MCP de cero dependencias para Jira Server / Data Center autohospedado — funciona en Jira 8.x, incluidas versiones anteriores a la 8.14 (no se necesita Personal Access Token).

Servidor MCP de Jira Server / Data Center con cero dependencias, implementado a mano con la biblioteca estándar de Python. No requiere pip install de ningún paquete de terceros; basta con Python 3.8+.

Por qué es necesario

• El MCP oficial de Atlassian solo es compatible con Jira Cloud, no con despliegues locales.

• El popular proyecto de código abierto mcp-atlassian requiere Jira Server 8.14+, porque depende de Personal Access Token (PAT).

• Muchas empresas todavía usan 8.13 y versiones anteriores, sin PAT, y solo pueden usar Basic Auth (usuario + contraseña).

• Este servicio admite tanto Basic Auth como PAT, cubriendo todas las versiones de 8.x.

Related MCP server: jira-mcp

Herramientas disponibles

Variables de entorno

Método de autenticación: si se establece JIRA_TOKEN, se usa Bearer Token (PAT); de lo contrario, se usa JIRA_USERNAME + JIRA_PASSWORD para Basic Auth.

Instalación y ejecución

Elige una de las tres opciones:

# 方式一：pipx 安装（推荐，全局可用 jira-server-mcp 命令）
pipx install git+https://github.com/zhao1749501038/jira-server-mcp

# 方式二：uvx 直接运行（不落盘）
uvx --from git+https://github.com/zhao1749501038/jira-server-mcp jira-server-mcp

# 方式三：直接运行源码（零依赖，连 pip 都不用）
git clone https://github.com/zhao1749501038/jira-server-mcp
python3 jira-server-mcp/jira_mcp_server.py

Integración con clientes MCP

WorkBuddy

~/.workbuddy/mcp.json:

{
  "mcpServers": {
    "jira": {
      "command": "/usr/bin/python3",
      "args": ["/path/to/jira_mcp_server.py"],
      "env": {
        "JIRA_BASE_URL": "https://jira.yourcompany.com",
        "JIRA_USERNAME": "your-username",
        "JIRA_PASSWORD": "your-password"
      }
    }
  }
}

Claude Code

claude mcp add --scope user jira \
  --env JIRA_BASE_URL=https://jira.yourcompany.com \
  --env JIRA_USERNAME=your-username --env JIRA_PASSWORD=your-password \
  -- /usr/bin/python3 /path/to/jira_mcp_server.py

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "jira": {
      "command": "/usr/bin/python3",
      "args": ["/path/to/jira_mcp_server.py"],
      "env": {
        "JIRA_BASE_URL": "https://jira.yourcompany.com",
        "JIRA_USERNAME": "your-username",
        "JIRA_PASSWORD": "your-password"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json, igual que en Claude Desktop.

Codex

~/.codex/config.toml:

[mcp_servers.jira]
command = "/usr/bin/python3"
args = ["/path/to/jira_mcp_server.py"]
env = { JIRA_BASE_URL = "https://jira.yourcompany.com", JIRA_USERNAME = "your-username", JIRA_PASSWORD = "your-password" }

Aviso de seguridad

• Las credenciales se escriben en texto plano en la configuración del cliente; no las incluyas en commits de Git. Se recomienda usar una cuenta de bot dedicada y aplicar el principio de mínimo privilegio (solo ver/crear/editar/comentar/transicionar/asignar, sin eliminación ni administración del sistema).

• Si se necesita compartir entre varias personas, se recomienda desplegar el servidor como un servidor MCP HTTP y centralizar la autenticación, en lugar de que cada persona guarde su propia contraseña.

Licencia

MIT