Сервер Jira MCP

Сервер Model Context Protocol (MCP) для интеграции Jira. Этот сервер позволяет помощникам ИИ, таким как Клод, взаимодействовать с Jira с помощью MCP.

Автор: Сэмюэл Риццо

Функции

Список всех проектов Jira
Получить подробную информацию о проблеме
Поиск проблем по проекту и исполнителю
Список участников проекта
Проверьте членство пользователя в проекте и назначенные ему задачи
Создавайте новые выпуски с пользовательскими полями
Список и запрос спринтов с возможностью фильтрации

Установка

# Clone the repository
git clone https://github.com/samuelrizzo/jira-mcp-server.git
cd jira-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Конфигурация

Конфигурация сервера MCP

Добавьте следующую конфигурацию в файл настроек курсора/windsurf mcp:

{
  "mcpServers": {
    "jira-mcp": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "JIRA_HOST": "your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Настройка API-доступа

Создайте токен Jira API:
- Перейдите в настройки учетной записи Atlassian.
- Нажмите «Создать токен API».
- Дайте ему имя и нажмите «Создать».
- Скопируйте токен (он понадобится для аутентификации)
Запишите URL-адрес вашего хоста Jira (например, your-domain.atlassian.net ) и адрес электронной почты, связанный с вашей учетной записью Atlassian.
Добавьте эти учетные данные в конфигурацию вашего сервера MCP.

Доступные инструменты

1. Список проектов ( `mcp_jira_list_projects` )

Перечисляет все проекты Jira, к которым имеет доступ аутентифицированный пользователь.

Параметры:

jiraHost : ваш домен Jira (например, «ваш-домен.atlassian.net»).
email : Ваш эл. адрес Jira
apiToken : Ваш токен API Jira

2. Получить сведения о проблеме ( `mcp_jira_get_issue` )

Извлекает подробную информацию о конкретной проблеме Jira.

Параметры:

issueKey : ключ задачи Jira (например, «PROJECT-123»)
jiraHost : Ваш домен Jira
email : Ваш эл. адрес Jira
apiToken : Ваш токен API Jira

3. Проблемы поиска ( `mcp_jira_search_issues` )

Поиск проблем в конкретном проекте с возможностью фильтрации по исполнителю.

Параметры:

projectKey : ключ проекта Jira
assigneeName : (Необязательно) Фильтрация проблем по имени ответственного
jiraHost : Ваш домен Jira
email : Ваш адрес электронной почты Jira
apiToken : Ваш токен API Jira

4. Список участников проекта ( `mcp_jira_list_project_members` )

Список всех участников определенного проекта Jira.

Параметры:

projectKey : ключ проекта Jira
jiraHost : Ваш домен Jira
email : Ваш эл. адрес Jira
apiToken : Ваш токен API Jira

5. Проверка проблем пользователей ( `mcp_jira_check_user_issues` )

Проверяет, является ли пользователь участником проекта, и выводит список назначенных ему задач.

Параметры:

projectKey : ключ проекта Jira
userName : Отображаемое имя пользователя для проверки.
jiraHost : Ваш домен Jira
email : Ваш эл. адрес Jira
apiToken : Ваш токен API Jira

6. Создать задачу ( `mcp_jira_create_issue` )

Создает новую задачу в проекте Jira с указанными подробностями.

Параметры:

projectKey : ключ проекта Jira
summary : Название/краткое содержание вопроса
description : Подробное описание проблемы
issueType : (Необязательно) Тип проблемы (например, «Задача», «Ошибка», «История»), по умолчанию «Задача»
assigneeName : (Необязательно) Отображаемое имя человека, которому необходимо назначить проблему.
reporterName : (Необязательно) Отображаемое имя человека, сообщившего о проблеме.
sprintId : (Необязательно) идентификатор спринта, в который нужно добавить задачу
jiraHost : Ваш домен Jira
email : Ваш эл. адрес Jira
apiToken : Ваш токен API Jira

7. Список спринтов ( `mcp_jira_list_sprints` )

Список текущих спринтов в Jira с возможностью фильтрации.

Параметры:

boardId : (Необязательно) идентификатор доски Jira для фильтрации спринтов по определенной доске
projectKey : (Необязательно) ключ проекта для поиска спринтов, связанных с проектом.
state : (Необязательно) состояние спринта для фильтрации (активный, будущий, закрытый или все), по умолчанию «активный»
jiraHost : Ваш домен Jira
email : Ваш эл. адрес Jira
apiToken : Ваш токен API Jira

Примеры использования

Вот несколько примеров запросов, которые вы можете использовать с Клодом:

"List all Jira projects in PROJECT"
"Get details for issue PROJECT-123"
"Search for issues assigned to John in PROJECT"
"List all members of PROJECT"
"Check what issues are assigned to Jane in PROJECT"
"Create a new bug issue titled 'Login page error' in PROJECT"
"List active sprints for PROJECT"

Постоянное развитие

Этот проект находится в стадии активной разработки. Регулярно добавляются новые инструменты и функции для расширения возможностей интеграции с Jira. Будущие обновления будут включать:

Дополнительные инструменты управления проблемами
Спринт и управление доской
Расширенные возможности поиска и фильтрации
Обработка пользовательских полей
Переходы рабочего процесса
И многое другое!

Следите за обновлениями репозитория, просматривая его или добавляя в избранное.

Внося вклад

Это проект с открытым исходным кодом, и вклад приветствуется! Чтобы внести свой вклад:

Форк репозитория
Создайте свою ветку функций
Внесите изменения
Отправить запрос на извлечение

Открытый исходный код

Этот код полностью открыт. Вы можете:

Копировать
Изменить
Распространять
Использовать в коммерческих целях
Использовать в частном порядке

Никаких ограничений — делайте с кодом все, что хотите!

Лицензия

Массачусетский технологический институт

Jira MCP Server

Integrations