백로그 MCP 서버
Backlog API를 통합한 MCP 서버 구현입니다.
도구
프로젝트 API
- 백로그_겟_프로젝트
- 페이지 매김 및 필터링을 사용하여 프로젝트 실행
- 백로그_겟_프로젝트
- 프로젝트 ID 또는 키로 프로젝트 가져오기 실행
API 문제
- 백로그_문제_수집
- 백로그_이슈_받기
- 백로그_추가_이슈
- 백로그 업데이트 이슈
- 백로그_삭제_이슈
위키 API
- 백로그_겟_위키
- 백로그_겟_위키
- 백로그_추가_위키
- 백로그_업데이트_위키
- 백로그 삭제 위키
구성
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"
}
}
}
}
개발
설치
짓다
디버그
테스트 실행
미정
도커 빌드
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 파일을 참조하세요.