mcp-backlog-server

Backlog MCP Server

이것은 Backlog와 Model Context Protocol (MCP)을 통합하는 TypeScript 기반 서버입니다. 다음 MCP의 주요 개념을 구현합니다.

• Backlog 프로젝트를 나타내는 리소스(URI 및 메타데이터 포함)
• Backlog API와 상호 작용하는 도구
• Backlog 데이터 요약 및 분석을 생성하기 위한 프롬프트

기능

자원

• backlog://project/[id] URI를 통해 Backlog 프로젝트에 액세스
• 각 프로젝트 리소스에는 프로젝트 메타데이터와 상세 정보가 포함됩니다.
• 구조화된 데이터 액세스를 위한 JSON 형식 리소스
• 프로젝트 내 과제(이슈) 액세스
• 프로젝트의 위키 페이지 액세스

도구

• get_backlog_user - 현재 Backlog 사용자 정보 검색
• get_backlog_space - Backlog 공간 정보 검색
• list_recent_projects - 최근에 본 Backlog 프로젝트 목록
  • 건수와 정렬 순서 설정 가능
• get_project_issues - 프로젝트 과제 얻기
  • 상태, 담당자, 페이지 네이션 등으로 필터링 가능
• get_issue_detail - 특정 과제에 대한 자세한 정보 얻기
• get_issue_comments - 과제 코멘트 얻기
• add_issue_comment - 과제에 댓글 추가
• get_issue_comment_count - 과제의 코멘트 수를 취득
• get_issue_comment - 특정 코멘트에 대한 자세한 정보 얻기
• get_wiki_page_list - Wiki 페이지 목록 얻기
  • 프로젝트 및 키워드로 필터링 가능
• get_wiki_page - 특정 위키 페이지에 대한 자세한 정보 얻기
• update_wiki_page - Wiki 페이지 업데이트

프롬프트

• summarize_projects - 최근에 본 Backlog 프로젝트의 요약 생성
• analyze_backlog_usage - 사용자, 공간 및 프로젝트 데이터를 기반으로 Backlog 사용 패턴 분석
• summarize_wiki_pages - 프로젝트 위키 페이지 요약 생성

요건

• API 액세스 권한이 있는 Backlog 계정
• 환경 변수:
  • BACKLOG_API_KEY : Backlog API 키
  • BACKLOG_SPACE_URL : Backlog 공간 URL (예 : https://your-space.backlog.com )

개발

종속성 설치:

서버 빌드:

자동 재빌드로 개발 :

설치

Claude Desktop에서 사용하려면 서버 설정을 추가합니다.

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

디버깅

MCP 서버는 표준 I/O를 통해 통신하므로 디버깅이 어려울 수 있습니다. MCP Inspector 를 사용하는 것이 좋습니다. 이것은 패키지 스크립트로 사용할 수 있습니다.

Inspector는 브라우저에서 디버깅 도구에 액세스하기 위한 URL을 제공합니다.

기술 상세

이 서버는 다음과 같은 주요 구성 요소로 구성됩니다.

• index.ts - 메인 진입점, MCP 서버 초기화 및 설정
• backlog-client.ts - Backlog API와의 통신을 처리하는 클라이언트
• handlers/
  • resource resource-handlers.ts , 과제, 위키 리소스 처리
  • tool-handlers.ts - Backlog API와의 상호 작용 도구
  • prompt-handlers.ts - 프롬프트 생성 기능
• types.ts - Backlog API 응답의 유형 정의
• config.ts - 환경 변수로부터의 설정 로드