백로그 MCP 서버

Backlog API를 통합한 MCP 서버 구현입니다.

도구

프로젝트 API

백로그_겟_프로젝트
- 페이지 매김 및 필터링을 사용하여 프로젝트 실행
백로그_겟_프로젝트
- 프로젝트 ID 또는 키로 프로젝트 가져오기 실행

API 문제

백로그_문제_수집
- 페이지 매김 및 필터링으로 문제를 해결하세요
백로그_이슈_받기
- 이슈 ID 또는 키로 이슈를 실행합니다.
백로그_추가_이슈
- 이슈 데이터를 사용하여 이슈 추가 실행
백로그 업데이트 이슈
- 이슈 데이터로 이슈 업데이트 실행
백로그_삭제_이슈
- 이슈 ID 또는 키로 이슈 삭제 실행

위키 API

백로그_겟_위키
- 키워드로 위키 실행
백로그_겟_위키
- 위키 ID 또는 키로 위키 실행
백로그_추가_위키
- 위키 데이터로 위키 추가 실행
백로그_업데이트_위키
- 위키 데이터로 위키 업데이트 실행
백로그 삭제 위키
- 위키 ID 또는 키로 위키 삭제 실행

구성

API 키 받기

백로그 에 가입하세요
플랜을 선택하세요 (무료 플랜은 여기에서 이용 가능합니다)
개별 설정도움말 에서 API 키를 생성하세요

환경 변수

이 서버에는 다음과 같은 환경 변수가 필요합니다.

필수의:
- BACKLOG_API_KEY : Backlog API 키
- BACKLOG_SPACE_ID : 백로그 공간 ID
선택 과목:
- BACKLOG_BASE_URL : Backlog 기본 URL(기본값: https://{your-space-id}.backlog.com/api/v2 )

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요:

엔피엑스

지엑스피1

도커

{
  "mcpServers": {
    "backlog": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BACKLOG_API_KEY=YOUR_API_KEY_HERE",
        "-e",
        "BACKLOG_SPACE_ID=YOUR_SPACE_ID_HERE",
        "mcp/backlog"
      ],
      "env": {
        "BACKLOG_API_KEY": "YOUR_API_KEY_HERE",
        "BACKLOG_SPACE_ID": "YOUR_SPACE_ID_HERE"
      }
    }
  }
}

개발

설치

npm install

짓다

npm run build

디버그

npm run debug

테스트 실행

미정

도커 빌드

docker build -t mcp/backlog -f Dockerfile .

서버 확장

새로운 도구를 추가하려면:

src/core/schema.ts 에 새로운 Zod 스키마를 정의합니다.
src/tools/toolDefinitions.ts 에 새 도구 정의를 추가하고 ALL_TOOLS 에 포함합니다.
src/tools/handlers.ts 에 새 핸들러를 만들고 toolHandlers 에 등록합니다.
src/services/ 디렉토리의 서비스에 비즈니스 로직을 구현합니다.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

Backlog MCP Server