MCP 아틀라시안

Atlassian 제품(Confluence 및 Jira)과 상호작용하기 위한 도구를 제공하는 MCP(Model Context Protocol) 서버입니다.

개요

이 MCP 서버는 AI 에이전트가 표준화된 인터페이스를 통해 Atlassian 제품과 상호 작용할 수 있도록 지원합니다. 다음과 같은 도구를 제공합니다.

• Confluence : 콘텐츠 검색, 공간 가져오기, 콘텐츠 검색 및 페이지 나열
• Jira : 이슈 검색, 이슈 세부 정보 가져오기, 프로젝트 나열 등

필수 조건

• Node.js(v16 이상)
• npm 또는 yarn
• API 토큰이 있는 Atlassian 계정
• Docker(컨테이너화된 배포를 위한 선택 사항)

설치

표준 설치

1. 저장소를 복제합니다.지엑스피1
2. 종속성 설치:
   npm install # or using make make install
3. Atlassian 자격 증명을 사용하여 루트 디렉토리에 .env 파일을 만듭니다.
   ATLASSIAN_HOST=https://your-domain.atlassian.net ATLASSIAN_EMAIL=your-email@example.com ATLASSIAN_API_TOKEN=your-api-token

도커 설치

1. 저장소를 복제합니다.
   git clone https://github.com/yourusername/mcp-atlassian.git cd mcp-atlassian
2. 위에서 설명한 대로 .env 파일을 만듭니다.
3. Docker 컨테이너를 빌드하고 실행합니다.
   # Build the Docker image make docker-build # Run the Docker container make docker-run # Or use Docker Compose make docker-compose

용법

서버 시작

이렇게 하면 MCP 서버가 시작되어 stdin에서 요청을 수신하고 stdout에서 응답합니다.

사용 가능한 도구

Confluence 도구

• search-confluence : CQL을 사용하여 Confluence에서 콘텐츠 검색
  • 매개변수: query (문자열)
• get-confluence-space : 특정 Confluence 공간에 대한 정보를 가져옵니다.
  • 매개변수: spaceKey (문자열)
• get-confluence-content : ID로 특정 콘텐츠를 가져옵니다
  • 매개변수: contentId (문자열)
• get-confluence-pages : 공간의 모든 페이지를 가져옵니다.
  • 매개변수: spaceKey (문자열), limit (숫자, 선택 사항)

지라 도구

• search-jira-issues : JQL을 사용하여 이슈 검색
  • 매개변수: jql (문자열), maxResults (숫자, 선택 사항)
• get-jira-issue : 키로 특정 이슈 가져오기
  • 매개변수: issueKey (문자열)
• get-jira-projects : 모든 프로젝트 가져오기
  • 매개변수: 없음
• get-jira-project : 키로 특정 프로젝트를 가져옵니다
  • 매개변수: projectKey (문자열)
• get-jira-issue-types : 모든 이슈 유형을 가져옵니다.
  • 매개변수: 없음

개발

프로젝트 구조

건물

테스트

Makefile 명령어

이 프로젝트에는 일반적인 작업을 단순화하는 Makefile이 포함되어 있습니다.

특허

MIT

기여하다

1. 저장소를 포크하세요
2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
4. 브랜치에 푸시( git push origin feature/amazing-feature )
5. 풀 리퀘스트 열기