Jira MCP Toolset

Jira MCP 서버

모델 컨텍스트 프로토콜(MCP)을 통해 Jira와 상호 작용하도록 설계된 도구 모음으로, 핵심 Jira 기능과 통합된 안내형 이슈 생성 및 업데이트 마법사를 제공합니다.

설치

이것을 클라이언트에 설치하려면:

지엑스피1

용법

...

구성

환경 변수

로컬에서 실행하려면 DEBUG 및 LOG_FILE_PATH를 .env에 넣으면 됩니다.

사용 가능한 도구

이 애플리케이션은 모델 컨텍스트 프로토콜을 통해 다음 도구를 제공합니다.

핵심 Jira 도구

• getJiraIssue : 해당 키로 Jira 이슈를 가져옵니다.
• analyzeJiraIssue : Jira 문제에 대한 포괄적인 분석을 수행합니다.
• jiraGet : 모든 Jira API GET 엔드포인트에서 데이터를 가져옵니다.
• getIssuesByJql : JQL 쿼리를 사용하여 Jira 이슈를 검색합니다.

이슈 생성 마법사 도구

이 도구들은 새로운 Jira 이슈를 생성하는 단계별 안내 프로세스를 제공합니다. 마법사는 생성 과정 전반에 걸쳐 상태를 유지하며, 일반적으로 프로세스 시작, 프로젝트 선택( getProjects ), 이슈 유형 선택( getIssueTypes ), 필요한 필드 검색 및 입력( getFields , updateFields ), 선택적으로 이슈 세부 정보 분석, 마지막으로 이슈 확인 및 생성( createIssue )의 단계를 포함합니다. getState 와 getStatus 사용하여 진행 상황을 모니터링하고, resetState 사용하여 처음부터 다시 시작합니다.

• issueCreation_getState : 마법사의 현재 내부 상태를 가져옵니다.
• issueCreation_getStatus : 마법사의 상위 수준 상태를 가져옵니다.
• issueCreation_initiateState : 새로운 마법사 상태를 초기화합니다.
• issueCreation_resetState : 마법사 상태를 재설정합니다.
• issueCreation_updateState : 마법사 상태(프로젝트, 이슈 유형, 필드, 단계)를 업데이트합니다.
• issueCreation_createIssue : 마법사의 상태를 사용하여 Jira 이슈를 생성합니다.
• issueCreation_getProjects : 사용 가능한 Jira 프로젝트를 검색합니다.
• issueCreation_getIssueTypes : 선택한 프로젝트에 사용 가능한 이슈 유형을 가져옵니다.
• issueCreation_getFields : 선택된 프로젝트/이슈 유형에 필요한 필드를 검색합니다.
• issueCreation_updateFields : 마법사 상태에서 특정 필드 값을 업데이트합니다.
• issueCreation_setAnalysisComplete : 분석 완료 플래그를 설정합니다.
• issueCreation_setUserConfirmation : 생성 전에 사용자 확인 플래그를 설정합니다.
• issueCreation_analyzeIssue : 마법사 컨텍스트 내에서 문제 세부 정보를 분석합니다.

이슈 업데이트 마법사 도구(통합 업데이트 워크플로)

이러한 도구는 새로 생성되었거나 이미 존재하는 모든 Jira 이슈를 업데이트할 수 있는 통합적이고 강력한 메커니즘을 제공합니다. 이제 모든 업데이트는 단일하고 일관된 워크플로를 사용합니다.

• issueUpdateWizard_loadIssueIntoState : 키로 Jira 이슈를 가져와서 통합 업데이트 워크플로를 위해 상태 관리자에 로드합니다.
• issueUpdateWizard_updateIssueFromState : 현재 상태(필드, 프로젝트, 유형 등)를 사용하여 로드된 모든 문제를 업데이트합니다.

주요 원칙:

• 모든 이슈 업데이트(신규 또는 기존)는 동일한 패턴을 따릅니다. 이슈를 상태로 로드하고, 필드를 수정하고, API를 통해 업데이트합니다.
• 새로운 이슈 업데이트와 기존 이슈 업데이트 사이에 코드 중복이 없습니다.
• 최소한이고 명시적이며 견고한 오류 처리.
• 업데이트 작업에 대한 100% 단위 테스트 적용 범위.

개발

테스트 실행

Jest는 테스트용으로 구성되어 있습니다. 테스트 모음을 실행하려면 다음을 수행하세요.

코드 품질 검사

유형 검사, 린팅, 테스트를 함께 실행하려면 다음을 수행합니다.

MCP Inspector로 실행

Model Context Protocol Inspector를 사용하여 로컬 개발 및 테스트를 수행하는 경우 -e 플래그를 사용하여 애플리케이션을 실행하고 필요한 환경 변수를 전달할 수 있습니다.

( build/index.js 사용하는 경우 먼저 프로젝트를 빌드했는지 확인하세요)

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENSE 파일을 참조하세요.