MCP 아틀라시안

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

개요

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

• Confluence : 콘텐츠 검색, 공간 가져오기, 콘텐츠 검색 및 페이지 나열

• Jira : 이슈 검색, 이슈 세부 정보 가져오기, 프로젝트 나열 등

Related MCP server: MCP Atlassian

필수 조건

• 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

용법

서버 시작

# Using npm
npm start

# Using make
make start

# Using Docker
make docker-run

이렇게 하면 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 : 모든 이슈 유형을 가져옵니다.

  • 매개변수: 없음

개발

프로젝트 구조

src/
├── config/         # Configuration files
├── examples/       # Example usage
├── services/       # Service classes for Atlassian APIs
│   ├── confluence.ts
│   └── jira.ts
├── tools/          # MCP tools
│   ├── search-confluence.ts
│   ├── get-confluence-space.ts
│   ├── get-confluence-content.ts
│   ├── get-confluence-pages.ts
│   ├── search-jira-issues.ts
│   ├── get-jira-issue.ts
│   ├── get-jira-projects.ts
│   ├── get-jira-project.ts
│   ├── get-jira-issue-types.ts
│   ├── utils.ts
│   └── index.ts
└── index.ts        # Main entry point

건물

# Using npm
npm run build

# Using make
make build

테스트

# Using npm
npm test

# Using make
make test

Makefile 명령어

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

# Display available commands
make help

특허

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. 풀 리퀘스트 열기