Сервер Jira MCP

Общайтесь с Jira на естественном языке, чтобы получать информацию и изменять свой проект. Используйте его с Claude Desktop в сочетании с пользовательским README, который вы создадите с информацией о проекте, чтобы вы могли делегировать задачи PM (например, если у вас есть список моей команды и их специализаций, назначайте любую новую задачу наиболее подходящему человеку).

Создано с использованием протокола контекста модели .

Сервер позволяет:

Создание и настройка проекта
Управление проблемами и подзадачами
Связывание проблем и зависимости
Автоматизированные рабочие процессы по решению проблем

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

Необходимые переменные среды:

JIRA_HOST : имя хоста вашего экземпляра Jira
JIRA_EMAIL : Электронная почта вашего аккаунта Jira
JIRA_API_TOKEN : токен API из https://id.atlassian.com/manage-profile/security/api-tokens

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

1. Управление пользователями

// Get user's account ID by email
{
  email: "user@example.com";
}

2. Управление типами проблем

// List all available issue types
// Returns: id, name, description, subtask status
// No parameters required

3. Типы ссылок на проблемы

// List all available issue link types
// Returns: id, name, inward/outward descriptions
// No parameters required

4. Управление проблемами

Получение проблем

// Get all issues in a project
{
  projectKey: "PROJECT"
}

// Get issues with JQL filtering
{
  projectKey: "PROJECT",
  jql: "status = 'In Progress' AND assignee = currentUser()"
}

// Get issues assigned to user
{
  projectKey: "PROJECT",
  jql: "assignee = 'user@example.com' ORDER BY created DESC"
}

Создание проблем

// Create a standard issue
{
  projectKey: "PROJECT",
  summary: "Issue title",
  issueType: "Task",  // or "Story", "Bug", etc.
  description: "Detailed description",
  assignee: "accountId",  // from get_user tool
  labels: ["frontend", "urgent"],
  components: ["ui", "api"],
  priority: "High"
}

// Create a subtask
{
  parent: "PROJECT-123",
  projectKey: "PROJECT",
  summary: "Subtask title",
  issueType: "Subtask",
  description: "Subtask details",
  assignee: "accountId"
}

Проблемы с обновлением

// Update issue fields
{
  issueKey: "PROJECT-123",
  summary: "Updated title",
  description: "New description",
  assignee: "accountId",
  status: "In Progress",
  priority: "High"
}

Зависимости проблемы

// Create issue link
{
  linkType: "Blocks",  // from list_link_types
  inwardIssueKey: "PROJECT-124",  // blocked issue
  outwardIssueKey: "PROJECT-123"  // blocking issue
}

Удаление проблем

// Delete single issue
{
  issueKey: "PROJECT-123"
}

// Delete issue with subtasks
{
  issueKey: "PROJECT-123",
  deleteSubtasks: true
}

// Delete multiple issues
{
  issueKeys: ["PROJECT-123", "PROJECT-124"]
}

Форматирование поля

Описание Поле

Поле описания поддерживает форматирование в стиле markdown:

Используйте пустые строки между абзацами.
Используйте «-» для маркеров.
Используйте «1.» для нумерованных списков.
Используйте заголовки, заканчивающиеся на «:» (с последующей пустой строкой)

Пример:

Task Overview:

This task involves implementing new features:
- Feature A implementation
- Feature B testing

Steps:
1. Design component
2. Implement logic
3. Add tests

Acceptance Criteria:
- All tests passing
- Documentation updated

Обработка ошибок

Сервер предоставляет подробные сообщения об ошибках для:

Недействительные ключи выпуска
Отсутствуют обязательные поля
Проблемы с разрешениями
Ограничения скорости API

Инструкции по установке

Клонируйте репозиторий:
git clone https://github.com/George5562/Jira-MCP-Server.git cd Jira-MCP-Server
Установите зависимости:
npm install
Настройте переменные среды: Создайте файл .env в корневом каталоге:
JIRA_HOST=your-instance.atlassian.net JIRA_EMAIL=your-email@example.com JIRA_API_TOKEN=your-api-token
Создайте проект:
npm run build
Запустите сервер:
npm start

Настройка рабочего стола Claude

Чтобы использовать этот MCP-сервер с Claude Desktop:

Найдите файл конфигурации Claude Desktop:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%/Claude/claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
Добавьте сервер Jira MCP в свою конфигурацию:
{ "mcpServers": { "jira-server": { "name": "jira-server", "command": "/path/to/node", "args": ["/path/to/jira-server/build/index.js"], "cwd": "/path/to/jira-server", "env": { "JIRA_HOST": "your-jira-instance.atlassian.net", "JIRA_EMAIL": "your-email@example.com", "JIRA_API_TOKEN": "your-api-token" } } } }
Замените /path/to/jira-server на абсолютный путь к вашему клонированному репозиторию. Замените /path/to/node на абсолютный путь к исполняемому файлу Node.js (обычно его можно найти, запустив which node или where node в терминале). Для надежности рекомендуется использовать прямой путь к исполняемому файлу Node.js и собранному файлу JavaScript ( build/index.js после запуска npm run build ).
Перезапустите Claude Desktop, чтобы изменения вступили в силу.

Настройка курсора

Чтобы использовать этот сервер Jira MCP с Cursor:

Убедитесь, что сервер собран: запустите npm run build в каталоге Jira-MCP-Server чтобы создать необходимый файл build/index.js .
Найдите или создайте файл конфигурации MCP курсора:
- Для конфигурации, специфичной для проекта: .cursor/mcp.json в корневом каталоге вашего проекта.
- Для глобальной конфигурации (все проекты): ~/.cursor/mcp.json в вашем домашнем каталоге.
Добавьте конфигурацию сервера Jira MCP в mcp.json :
{ "mcpServers": { "jira-mcp-server": { "command": "node", // Or provide the absolute path to your Node.js executable "args": [ "/path/to/your/Jira-MCP-Server/build/index.js" // Absolute path to the server's built index.js ], "cwd": "/path/to/your/Jira-MCP-Server", // Absolute path to the Jira-MCP-Server directory "env": { "JIRA_HOST": "your-jira-instance.atlassian.net", "JIRA_EMAIL": "your-email@example.com", // Your Jira email "JIRA_API_TOKEN": "your-api-token" // Your Jira API token } } // You can add other MCP server configurations here } }
- Замените /path/to/your/Jira-MCP-Server на правильный абсолютный путь к месту, куда вы клонировали репозиторий Jira-MCP-Server .
- Если node отсутствует в системной переменной PATH или вы предпочитаете абсолютный путь, замените "node" на полный путь к исполняемому файлу Node.js (например, /usr/local/bin/node или C:\Program Files\nodejs\node.exe ).
- Убедитесь, что данные вашего экземпляра Jira и токен API правильно заполнены в разделе env .
Перезапустите курсор , чтобы изменения вступили в силу.

Использование правил курсора для контекста Jira

Чтобы сделать взаимодействие с Jira более плавным, вы можете определить свой проект Jira по умолчанию и идентификатор пользователя в правилах Cursor. Это помогает ИИ Cursor понимать ваш контекст без необходимости указывать его в каждом запросе.

Создайте или отредактируйте файл правил курсора (например, в вашем проекте .cursor/rules.json или глобальном ~/.cursor/rules.json (точный файл и метод для правил могут отличаться, см. документацию по курсору в разделе «Правила» или «Управление контекстом»). Добавьте записи, например:

As an AI assistant, when I am asked about Jira tasks:
- Assume the primary Jira project key is 'YOUR_PROJECT_KEY_HERE'.
- Assume 'my assigned tasks' or tasks assigned to 'me' refer to the Jira user with the email 'your_jira_email@example.com' (or your Jira Account ID).
You can then use these in your JQL queries, for example: project = YOUR_PROJECT_KEY_HERE AND assignee = 'your_jira_email@example.com'.

Замените YOUR_PROJECT_KEY_HERE и your_jira_email@example.com на свои фактические данные.

Пример использования в курсорном чате

После настройки (особенно с использованием правил курсора для контекста) вы можете задать курсору:

"Using Jira MCP, list my assigned tasks. Then, based on these tasks, come up with an implementation plan and work schedule."

Если вы не установили правила или вам нужно указать другой проект или пользователя, вы можете сделать это более явно:

"Using Jira MCP, list tasks assigned to 'user@example.com' in project 'PROJECT_KEY'. Then, based on these tasks, come up with an implementation plan and work schedule."

Искусственный интеллект Cursor будет использовать сервер Jira MCP для извлечения задач, а затем приступит к выполнению запроса на планирование и составление графика.

Установка через Smithery

Чтобы автоматически установить Jira MCP Server для Claude Desktop через Smithery :

npx -y @smithery/cli install @George5562/Jira-MCP-Server --client claude

Ручная установка

Клонируйте репозиторий:
git clone https://github.com/George5562/Jira-MCP-Server.git cd Jira-MCP-Server
Установите зависимости:
npm install
Настройте переменные среды: Создайте файл .env в корневом каталоге:
JIRA_HOST=your-instance.atlassian.net JIRA_EMAIL=your-email@example.com JIRA_API_TOKEN=your-api-token
Создайте проект:
npm run build
Запустите сервер:
npm start

Ссылки

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

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

View all tools

Обеспечивает взаимодействие с Jira на естественном языке для управления проектами, проблемами, задачами и рабочими процессами через протокол контекста модели, позволяя пользователям делегировать задачи управления проектами через Claude Desktop.

Related Resources

Reddit Discussion about this server

Related MCP Servers

HH JIRA MCP Server
alexeydubinin
A
security
F
license
A
quality
A Model Context Protocol server that enables integration with JIRA, allowing users to interact with JIRA tasks and issues through Claude AI assistant.
Last updated -
3
2
Python
Jira MCP Server
ParasSolanki
A
security
A
license
A
quality
A Model Context Protocol server that provides integration with Jira, allowing Large Language Models to interact with Jira projects, boards, sprints, and issues through natural language.
Last updated -
5
87
2
TypeScript
MIT License
JIRA MCP Tools
NZenitram
-
security
F
license
-
quality
A Model Context Protocol (MCP) server that enables interaction with JIRA APIs through Claude Desktop, allowing users to search, create, update, and manage JIRA issues using natural language commands.
Last updated -
Python
Jira MCP Server
samuelrizzo
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with Jira, allowing for project management tasks such as listing projects, searching issues, creating tickets, and managing sprints through natural language queries.
Last updated -
12
1
TypeScript
MIT License

View all related MCP servers

Jira MCP Server