Confluence Cloud MCP 서버

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

특징

• 공간 관리

  • 공간 나열

  • 공간 세부 정보 가져오기

• 페이지 작업

  • 페이지 만들기, 읽기, 업데이트

  • 공간에 페이지 나열

  • Confluence 저장 형식의 페이지 콘텐츠를 Markdown으로 변환

• 검색 및 라벨

  • CQL을 사용하여 콘텐츠 검색

  • 페이지 라벨 관리

Related MCP server: Confluence MCP Server

설정

옵션 1: Docker 사용(권장)

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

지엑스피1

옵션 2: 지역적으로 구축

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

git clone https://github.com/aaronsb/confluence-cloud-mcp.git
cd confluence-cloud-mcp

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

# Build the Docker image
./scripts/build-local.sh

# Run the server
CONFLUENCE_API_TOKEN=your-token CONFLUENCE_EMAIL=your-email ./scripts/run-local.sh

옵션 3: 소스에서

1. 종속성 설치:

npm install

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

CONFLUENCE_DOMAIN=your-domain.atlassian.net
CONFLUENCE_EMAIL=your-email@domain.com
CONFLUENCE_API_TOKEN=your-api-token

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

npm run build

4. 서버를 실행합니다:

node build/index.js

용법

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

{
  "mcpServers": {
    "confluence": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/aaronsb/confluence-cloud-mcp:latest"],
      "env": {
        "CONFLUENCE_DOMAIN": "your-domain.atlassian.net",
        "CONFLUENCE_EMAIL": "your-email@domain.com",
        "CONFLUENCE_API_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

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