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 - 프로젝트 위키 페이지 요약 생성

Related MCP server: Linear MCP Server

요건

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

개발

종속성 설치:

npm install

서버 빌드:

npm run build

자동 재빌드로 개발 :

npm run watch

설치

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

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

{
  "mcpServers": {
    "mcp-backlog-server": {
      "command": "/path/to/mcp-backlog-server/build/index.js",
      "env": {
        "BACKLOG_API_KEY": "your-api-key",
        "BACKLOG_SPACE_URL": "https://your-space.backlog.com"
      }
    }
  }
}

디버깅

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

npm run 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 - 환경 변수로부터의 설정 로드