MCP 아틀라시안
Atlassian 제품(Confluence 및 Jira)과 상호작용하기 위한 도구를 제공하는 MCP(Model Context Protocol) 서버입니다.
개요
이 MCP 서버는 AI 에이전트가 표준화된 인터페이스를 통해 Atlassian 제품과 상호 작용할 수 있도록 지원합니다. 다음과 같은 도구를 제공합니다.
- Confluence : 콘텐츠 검색, 공간 가져오기, 콘텐츠 검색 및 페이지 나열
- Jira : 이슈 검색, 이슈 세부 정보 가져오기, 프로젝트 나열 등
필수 조건
- Node.js(v16 이상)
- npm 또는 yarn
- API 토큰이 있는 Atlassian 계정
- Docker(컨테이너화된 배포를 위한 선택 사항)
설치
표준 설치
- 저장소를 복제합니다.지엑스피1
- 종속성 설치:
npm install
# or using make
make install
- Atlassian 자격 증명을 사용하여 루트 디렉토리에
.env 파일을 만듭니다.ATLASSIAN_HOST=https://your-domain.atlassian.net
ATLASSIAN_EMAIL=your-email@example.com
ATLASSIAN_API_TOKEN=your-api-token
도커 설치
- 저장소를 복제합니다.
git clone https://github.com/yourusername/mcp-atlassian.git
cd mcp-atlassian
- 위에서 설명한 대로
.env 파일을 만듭니다. - 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에서 콘텐츠 검색
- get-confluence-space : 특정 Confluence 공간에 대한 정보를 가져옵니다.
- get-confluence-content : ID로 특정 콘텐츠를 가져옵니다
- get-confluence-pages : 공간의 모든 페이지를 가져옵니다.
- 매개변수:
spaceKey (문자열), limit (숫자, 선택 사항)
지라 도구
- search-jira-issues : JQL을 사용하여 이슈 검색
- 매개변수:
jql (문자열), maxResults (숫자, 선택 사항)
- get-jira-issue : 키로 특정 이슈 가져오기
- get-jira-projects : 모든 프로젝트 가져오기
- get-jira-project : 키로 특정 프로젝트를 가져옵니다
- 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
기여하다
- 저장소를 포크하세요
- 기능 브랜치를 생성합니다(
git checkout -b feature/amazing-feature ) - 변경 사항을 커밋하세요(
git commit -m 'Add some amazing feature' ) - 브랜치에 푸시(
git push origin feature/amazing-feature ) - 풀 리퀘스트 열기