Jira Server MCP

MCP-сервер без внешних зависимостей для самостоятельного размещения Jira Server / Data Center — работает на Jira 8.x, включая версии до 8.14 (Personal Access Token не требуется).

MCP-сервер для Jira Server / Data Center без внешних зависимостей, реализованный вручную на стандартной библиотеке Python, без необходимости pip install каких-либо сторонних пакетов — достаточно Python 3.8+.

Зачем это нужно

• Официальный MCP от Atlassian поддерживает только Jira Cloud и не поддерживает локальное развертывание

• Популярный open-source mcp-atlassian требует Jira Server 8.14+, так как он зависит от Personal Access Token (PAT)

• Многие компании до сих пор используют версии 8.13 и более ранние, где нет PAT, и доступен только Basic Auth (имя пользователя + пароль)

• Данный сервер поддерживает одновременно Basic Auth и PAT, покрывая все версии 8.x

Related MCP server: jira-mcp

Предоставляемые инструменты

Переменные окружения

Способ аутентификации: если задан JIRA_TOKEN, используется Bearer Token (PAT), в противном случае — Basic Auth с JIRA_USERNAME + JIRA_PASSWORD.

Установка и запуск

Выберите любой из трех способов:

# 方式一：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

Подключение к различным 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, запись аналогична 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" }

Предупреждение о безопасности

• Учетные данные хранятся в конфигурации клиента в открытом виде, не отправляйте их в Git; рекомендуется использовать выделенную учетную запись бота с минимальными правами (только просмотр/создание/редактирование/комментирование/переходы/назначение, без удаления и администрирования системы).

• При необходимости совместного использования несколькими людьми рекомендуется развернуть сервер как HTTP MCP Server с единой аутентификацией, а не хранить пароли у каждого отдельно.

Лицензия

MIT