Confluence MCP Server

Confluence Cloud MCP 서버

Confluence Cloud와 상호 작용하기 위한 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 어시스턴트는 표준화된 인터페이스를 통해 Confluence 공간, 페이지 및 콘텐츠를 관리할 수 있습니다.

특징

• 공간 관리
  • 공간 나열
  • 공간 세부 정보 가져오기
• 페이지 작업
  • 페이지 만들기, 읽기, 업데이트
  • 공간에 페이지 나열
  • Confluence 저장 형식의 페이지 콘텐츠를 Markdown으로 변환
• 검색 및 라벨
  • CQL을 사용하여 콘텐츠 검색
  • 페이지 라벨 관리

설정

옵션 1: Docker 사용(권장)

이 서버를 사용하는 가장 쉬운 방법은 미리 빌드된 Docker 이미지를 사용하는 것입니다.

지엑스피1

옵션 2: 지역적으로 구축

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

2. 로컬 빌드 스크립트를 사용하여 빌드하고 실행합니다.

옵션 3: 소스에서

1. 종속성 설치:

2. 환경 변수 구성: Confluence 자격 증명으로 .env 파일을 만듭니다.

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

4. 서버를 실행합니다:

용법

서버를 MCP 구성에 추가하여 MCP 호환 AI 어시스턴트와 통합할 수 있습니다.

AI 도우미를 위한 참고 사항 : 클라인과 같은 AI 도우미가 이 MCP 서버를 설치하려는 경우, 자세한 설치 지침은 llms-install.md 파일을 참조하세요.

사용 가능한 도구

우주 도구

• list_confluence_spaces : Confluence의 모든 공간을 나열합니다.
• get_confluence_space : 특정 공간에 대한 세부 정보를 가져옵니다.

페이지 도구

• list_confluence_pages : 공간의 페이지 목록
• get_confluence_page : 특정 페이지와 해당 페이지를 가져옵니다(이제 마크다운 변환 포함)
• create_confluence_page : 공간에 새 페이지를 만듭니다.
• update_confluence_page : 기존 페이지 업데이트

get_confluence_page 도구는 이제 Confluence 저장 형식 콘텐츠를 마크다운으로 자동 변환하여 페이지 콘텐츠 작업을 더욱 간편하게 만들어 줍니다. 변환 기능은 다음을 처리합니다.

• 헤더(h1-h6)
• 목록(순서가 있는 목록과 순서가 없는 목록)
• 모래밭
• 강조(굵게/기울임체)
• 코드 블록
• 테이블
• 문단과 줄 바꿈

검색 및 레이블 도구

• search_confluence_pages : CQL을 사용하여 Confluence 콘텐츠 검색
• get_confluence_labels : 페이지의 레이블을 가져옵니다.
• add_confluence_label : 페이지에 라벨을 추가합니다.
• remove_confluence_label : 페이지에서 라벨을 제거합니다.

참고 : 모든 도구 이름은 일관성과 명확성을 위해 [동사] 합류 [명사] 명명 규칙을 따릅니다.

개발

이 프로젝트는 TypeScript로 작성되었으며, 서버 기능 구현을 위한 MCP SDK 규칙을 따릅니다. 코드베이스는 다음과 같이 구성됩니다.

• src/client/ - Confluence API 클라이언트 구현
• src/handlers/ - MCP 도구 요청 핸들러
• src/schemas/ - 도구 입력을 위한 JSON 스키마
• src/types/ - TypeScript 유형 정의
• src/utils/ - 콘텐츠 형식 변환을 포함한 유틸리티 함수

CI/CD 파이프라인

이 프로젝트에서는 지속적인 통합 및 배포를 위해 GitHub Actions를 사용합니다.

• 풀 리퀘스트에 대한 자동화된 테스트 및 린팅
• 메인 브랜치 커밋을 기반으로 자동 Docker 이미지 빌드
• 다중 아키텍처 이미지 빌드(amd64, arm64)
• GitHub 컨테이너 레지스트리에 컨테이너 게시

지역 개발

로컬 개발을 위해 제공된 스크립트를 사용하세요.

• ./scripts/build-local.sh : 프로젝트를 빌드하고 로컬 Docker 이미지를 생성합니다.
• ./scripts/run-local.sh : 자격 증명을 사용하여 로컬 Docker 이미지를 실행합니다.

특허

MIT