Skip to main content
Glama
Jira Insights MCP

Jira Insights MCP

by aaronsb

Jira Insights MCP

Jira Insights(JSM) 자산 스키마를 관리하기 위한 MCP(모델 컨텍스트 프로토콜) 서버입니다.

최종 업데이트: 2025-04-09

개요

이 MCP 서버는 모델 컨텍스트 프로토콜을 통해 Jira Insights(JSM) 자산 스키마와 상호 작용하는 도구를 제공합니다. Jira Insights에서 객체 스키마, 객체 유형 및 객체를 관리할 수 있습니다.

Related MCP server: MCP Atlassian

특징

  • 개체 스키마 관리(생성, 읽기, 업데이트, 삭제)

  • 객체 유형 관리(생성, 읽기, 업데이트, 삭제)

  • 객체 관리(생성, 읽기, 업데이트, 삭제)

  • AQL(Atlassian Query Language)을 사용하여 객체 쿼리

필수 조건

  • Node.js 20 이상

  • Docker(컨테이너화된 배포용)

  • API 액세스가 가능한 Jira Insights 인스턴스

  • 적절한 권한이 있는 Jira API 토큰

설치

지역 개발

  1. 저장소를 복제합니다.

    지엑스피1

  2. 종속성 설치:

    npm install
  3. 프로젝트를 빌드하세요:

    npm run build

도커

Docker 이미지를 빌드합니다.

./scripts/build-local.sh

용법

MCP 구성

Claude나 Model Context Protocol을 지원하는 다른 AI 어시스턴트와 함께 이 MCP 서버를 사용하려면 다음 방법 중 하나를 사용하여 MCP 구성에 추가하세요.

로컬 빌드 구성

프로젝트를 로컬로 빌드한 경우 다음 구성을 사용하세요.

{
  "mcpServers": {
    "jira-insights": {
      "command": "node",
      "args": ["/path/to/jira-insights-mcp/build/index.js"],
      "env": {
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "LOG_MODE": "strict"
      }
    }
  }
}

Docker 기반 구성

Docker 이미지를 사용하려는 경우(대부분 사용자에게 권장) 다음 구성을 사용하세요.

{
  "mcpServers": {
    "jira-insights": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "JIRA_API_TOKEN",
        "-e", "JIRA_EMAIL",
        "-e", "JIRA_HOST",
        "ghcr.io/aaronsb/jira-insights-mcp:latest"
      ],
      "env": {
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_HOST": "https://your-domain.atlassian.net"
      }
    }
  }
}

이 Docker 기반 구성은 GitHub Container Registry에서 최신 이미지를 가져와서 필요한 환경 변수와 함께 실행합니다.

개발을 위한 지역적 실행

로컬 개발 및 테스트를 위해:

# Build the Docker image
./scripts/build-local.sh

# Run the Docker container
JIRA_API_TOKEN=your_token JIRA_EMAIL=your_email JIRA_HOST=your_host ./scripts/run-local.sh

사용 가능한 도구

관리_jira_insight_schema

CRUD 작업을 통해 Jira Insights 개체 스키마를 관리합니다.

{
  "operation": "list",
  "maxResults": 10
}

관리_jira_insight_객체_유형

CRUD 작업을 통해 Jira Insights 객체 유형을 관리합니다.

{
  "operation": "list",
  "schemaId": "1",
  "maxResults": 20
}

Jira_Insight_객체 관리

CRUD 작업과 AQL 쿼리를 사용하여 Jira Insights 객체를 관리합니다.

{
  "operation": "query",
  "aql": "objectType = \"Application\"",
  "maxResults": 10
}

사용 가능한 리소스

MCP 서버는 Jira Insights 데이터에 액세스하기 위한 여러 리소스를 제공합니다.

  • jira-insights://instance/summary - Jira Insights 인스턴스에 대한 고급 통계

  • jira-insights://aql-syntax - 예제를 포함한 자산 쿼리 언어(AQL) 구문에 대한 포괄적인 가이드

  • jira-insights://schemas/all - 모든 스키마와 해당 객체 유형의 전체 목록

  • jira-insights://schemas/{schemaId}/full - 객체 유형을 포함한 특정 스키마의 완전한 정의

  • jira-insights://schemas/{schemaId}/overview - 메타데이터 및 통계를 포함한 특정 스키마 개요

  • jira-insights://object-types/{objectTypeId}/overview - 속성 및 통계를 포함한 특정 객체 유형에 대한 개요

계획된 개선 사항

Jira Insights MCP의 기능과 사용성을 향상시키기 위해 여러 가지 개선 작업을 진행하고 있습니다.

우선순위가 높은 개선 사항

  1. 향상된 오류 처리

    • 특정 검증 문제가 있는 보다 자세한 오류 메시지

    • 일반적인 오류에 대한 제안된 수정 사항

    • 사용자가 문제를 해결하는 데 도움이 되는 작업별 예

  2. AQL 쿼리 개선

    • AQL 쿼리에 대한 검증 및 포맷팅 유틸리티

    • 스키마별 예제 쿼리

    • 쿼리 문제에 대한 더 나은 오류 메시지

  3. 속성 발견 향상

    • 객체 유형에 대한 속성 검색이 개선되었습니다.

    • 더 나은 성능을 위한 캐싱

    • "확장" 매개변수의 더 나은 처리

중간 우선 순위 개선

  1. 객체 템플릿 생성

    • 객체 유형에 따라 객체를 생성하기 위한 템플릿

    • 유형별 플레이스홀더 생성

    • 템플릿의 검증 규칙

  2. 예제 쿼리 라이브러리

    • 스키마별 예제 쿼리

    • 컨텍스트 인식 쿼리 제안

    • 일반적인 작업을 위한 쿼리 템플릿

  3. 개선된 문서

    • 향상된 AQL 구문 문서

    • 작업별 문서

    • 일반적인 오류 시나리오 및 솔루션

계획된 개선 사항에 대한 자세한 내용은 다음을 참조하세요.

  • TODO.md - 모든 작업을 우선순위별로 정리한 포괄적인 할 일 목록

  • IMPLEMENTATION_PLAN.md - 우선순위가 높은 개선 사항에 대한 자세한 구현 계획

  • HANDLER_IMPROVEMENTS.md - 각 핸들러 파일에 필요한 특정 변경 사항

  • IMPROVEMENT_SUMMARY.md - 계획된 개선 사항에 대한 간략한 요약

  • docs/API_MIGRATION_TODO.md - API 마이그레이션 상태 및 계획된 개선 사항

개발

스크립트

  • npm run build : TypeScript 코드 빌드

  • npm run lint : ESLint 실행

  • npm run lint:fix : 자동 수정으로 ESLint 실행

  • npm run test : 테스트 실행

  • npm run watch : 변경 사항을 확인하고 다시 빌드합니다.

  • npm run generate-diagrams : TypeScript 종속성 다이어그램 생성

도커 스크립트

  • ./scripts/build-local.sh : Docker 이미지 빌드

  • ./scripts/run-local.sh : Docker 컨테이너를 실행합니다.

문제 해결

일반적인 문제

  1. AQL 쿼리 검증 오류

    • 공백이 포함된 값은 따옴표로 묶어야 합니다: Name = "John Doe"

    • 논리 연산자에는 대문자를 사용하세요: AND , OR (not and , or )

    • 스키마에 개체 유형과 속성이 있는지 확인하세요.

  2. 객체 유형 속성 문제

    • "속성"과 함께 "확장" 매개변수를 사용할 때 개체 유형이 존재하는지 확인하십시오.

    • 속성을 볼 수 있는 권한이 있는지 확인하세요

  3. API 연결 문제

    • Jira API 토큰에 필요한 권한이 있는지 확인하세요.

    • Jira 호스트 URL이 올바른지 확인하세요

    • 네트워크에서 Jira API에 대한 연결이 허용되는지 확인하세요.

특허

MIT

Available Tools

3 tools
manage_jira_insight_objectC

Manage Jira Insights objects with CRUD operations and AQL queries

Inputs: operation (required), aql, attributes, expand, +12 more.

manage_jira_insight_object_typeC

Manage Jira Insights object types with CRUD operations

Inputs: operation (required), description, expand, icon, +5 more.

manage_jira_insight_schemaC

Manage Jira Insights object schemas with CRUD operations

Inputs: operation (required), description, expand, maxResults, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting different Jira Insights components: objects, object types, and schemas. The descriptions specify unique domains (objects, object types, schemas) with no overlap in functionality, making it easy for an agent to select the correct tool.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with 'manage_jira_insight_' prefix followed by the specific component (object, object_type, schema). This predictable naming convention enhances readability and usability across the tool set.

    Tool Count3/5

    With only 3 tools, the count feels thin for a server named 'Jira Insights MCP', which might imply broader functionality. However, it covers core management areas adequately, though it could benefit from additional tools for querying or reporting to be more comprehensive.

    Completeness4/5

    The tools provide CRUD operations for key Jira Insights components (objects, types, schemas), covering essential management tasks. A minor gap exists in lacking dedicated query or analysis tools beyond AQL mentioned in one description, but core workflows are well-supported.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Model Context Protocol (MCP) server for Atlassian Cloud products (Confluence and Jira). This integration is designed specifically for Atlassian Cloud instances and does not support Atlassian Server or Data Center deployments.
      6,140
      MIT
    • -
      license
      Not graded
      quality
      C
      maintenance
      A local MCP server for administering Atlassian Cloud Assets and Jira, providing hundreds of tools for schemas, projects, workflows, and more.
      -