CJ

camdenclark/jira-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

28 stars 10 forks Качество 66 Тренд 11MIT

MCP-сервер, который позволяет Большим Языковым Моделям (LLM) взаимодействовать с JIRA через стандартизированные инструменты и контекст.

Обзор

MCP-сервер, который позволяет Большим Языковым Моделям (LLM) взаимодействовать с JIRA через стандартизированные инструменты и контекст. Этот сервер предоставляет возможности для поиска проблем с помощью JQL и извлечения подробной информации о проблеме. Выполнять сложные запросы JQL с поддержкой пагинации: Получать подробную информацию о конкретных проблемах JIRA - установлен npm - экземпляр JIRA с доступом к API - токен JIRA API или токен личного доступа - электронная почта пользователя JIRA, связанная с токеном API 1. Войдите в свой атласский аккаунт https://id.atlassian.com 2. Перейдите к настройкам безопасности 3. Под токенами API выберите «Создать токен API» 4. Дайте вашему токену значимое имя (например, «MCP Server») 5. Копируйте сгенерированный токен - вы не сможете увидеть его снова! 6.Используйте этот токен в качестве JIRA API KEY 7. Используйте адрес электронной почты, связанный с вашей учетной записью Atlassian, как JIRA USER EMAIL 1.

Обзор (машинный перевод)

MCP-сервер, который позволяет Большим Языковым Моделям (LLM) взаимодействовать с JIRA через стандартизированные инструменты и контекст. Этот сервер предоставляет возможности для поиска проблем с помощью JQL и извлечения подробной информации о проблеме.

Особенности

JQL Search: Выполняйте сложные запросы JQL с поддержкой пагинации Подробности: Получить подробную информацию по конкретным вопросам ОИРА

Предпосылки

  • [[Т0]] установленный Пример JIRA с доступом к API JIRA API или персональный токен доступа
  • Пользовательская электронная почта JIRA, связанная с токеном API

Получение сертификатов JIRA API

  1. Войдите в свой атласский аккаунт https://id.atlassian.com
  2. Навигация по настройкам безопасности
  3. Под токенами API выберите «Создать токен API»
  4. дать вашему токену значимое имя (например, «MCP Server»). 5.Копируйте сгенерированный токен - вы не сможете увидеть его снова!
  5. используйте этот токен в качестве своего JIRA_API_KEY
  6. Используйте адрес электронной почты, связанный с вашей учетной записью Atlassian, как JIRA_USER_EMAIL

Использование

Интеграция с Claude Desktop

  1. Добавить конфигурацию сервера в файл конфигурации Claude Desktop:

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

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

JIRA MCP Server

An MCP server that enables Large Language Models (LLMs) to interact with JIRA through standardized tools and context. This server provides capabilities for searching issues using JQL and retrieving detailed issue information.

Features

  • JQL Search: Execute complex JQL queries with pagination support
  • Issue Details: Retrieve detailed information about specific JIRA issues

Prerequisites

  • npm installed
  • A JIRA instance with API access
  • JIRA API token or Personal Access Token
  • JIRA user email associated with the API token

Getting JIRA API Credentials

  1. Log in to your Atlassian account at https://id.atlassian.com
  2. Navigate to Security settings
  3. Under API tokens, select “Create API token”
  4. Give your token a meaningful name (e.g., “MCP Server”)
  5. Copy the generated token - you won’t be able to see it again!
  6. Use this token as your JIRA_API_KEY
  7. Use the email address associated with your Atlassian account as JIRA_USER_EMAIL

Usage

Integration with Claude Desktop

  1. Add the server configuration to Claude Desktop’s config file:

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

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp"],
      "env": {
        "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net",
        "JIRA_USER_EMAIL": "[email protected]",
        "JIRA_API_KEY": "your-api-token"
      }
    }
  }
}
  1. Restart Claude Desktop to load the new configuration.

Available Tools

1. JQL Search (jql_search)

Executes a JQL search query with customizable parameters.

Parameters:

  • jql (required): JQL query string
  • nextPageToken: Token for pagination
  • maxResults: Maximum number of results to return
  • fields: Array of field names to include
  • expand: Additional information to include

Example:

{
  "jql": "project = 'MyProject' AND status = 'In Progress'",
  "maxResults": 10,
  "fields": ["summary", "status", "assignee"]
}

2. Get Issue (get_issue)

Retrieves detailed information about a specific issue.

Parameters:

  • issueIdOrKey (required): Issue ID or key
  • fields: Array of field names to include
  • expand: Additional information to include
  • properties: Array of properties to include
  • failFast: Whether to fail quickly on errors

Example:

{
  "issueIdOrKey": "PROJ-123",
  "fields": ["summary", "description", "status"],
  "expand": "renderedFields,names"
}

Development

Configuration

Set up your environment variables before running the server. Create a .env file in the root directory:

Открыть полный README на GitHub

Установка

npx -y jira-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

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

{ "mcpServers": { "jira": { "command": "npx", "args": ["-y", "jira-mcp"], "env": { "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net", "JIRA_USER_EMAIL": "[email protected]", "JIRA_API_KEY": "your-api-token" } } } }