Confluence Cloud MCP 서버
Confluence Cloud와 상호 작용하기 위한 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 어시스턴트는 표준화된 인터페이스를 통해 Confluence 공간, 페이지 및 콘텐츠를 관리할 수 있습니다.
특징
공간 관리
공간 나열
공간 세부 정보 가져오기
페이지 작업
페이지 만들기, 읽기, 업데이트
공간에 페이지 나열
Confluence 저장 형식의 페이지 콘텐츠를 Markdown으로 변환
검색 및 라벨
CQL을 사용하여 콘텐츠 검색
페이지 라벨 관리
Related MCP server: Confluence MCP
설정
옵션 1: Docker 사용(권장)
이 서버를 사용하는 가장 쉬운 방법은 미리 빌드된 Docker 이미지를 사용하는 것입니다.
지엑스피1
옵션 2: 지역적으로 구축
저장소를 복제합니다.
로컬 빌드 스크립트를 사용하여 빌드하고 실행합니다.
옵션 3: 소스에서
종속성 설치:
환경 변수 구성: Confluence 자격 증명으로
.env파일을 만듭니다.
프로젝트를 빌드하세요:
서버를 실행합니다:
용법
서버를 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