mcp-azure-devops

⚠️ 공지: 공식 서버 사용 가능

대신 공식 Microsoft Azure DevOps MCP 서버를 사용해 주세요: 이 저장소는 더 이상 유지 관리되지 않습니다. 공식 Microsoft 서버가 더 나은 지원, 지속적인 유지 관리 및 최신 기능을 제공합니다.

AI 어시스턴트가 Azure DevOps 서비스와 상호 작용할 수 있도록 하는 Model Context Protocol (MCP) 서버입니다.

이 프로젝트는 AI 어시스턴트(Claude 등)가 Azure DevOps와 상호 작용할 수 있도록 하는 Model Context Protocol (MCP) 서버를 구현하여, 자연어 상호 작용과 Azure DevOps REST API 사이의 가교 역할을 제공합니다.

현재 구현된 기능:

작업 항목(Work Items) 쿼리: WIQL 쿼리를 사용하여 작업 항목 검색
작업 항목 상세 정보 가져오기: 전체 작업 항목 정보 보기
작업 항목 생성: 새로운 작업(tasks), 버그(bugs), 사용자 스토리(user stories) 및 기타 작업 항목 유형 추가
작업 항목 업데이트: 기존 작업 항목의 필드 및 속성 수정
댓글 추가: 작업 항목에 댓글 게시
댓글 보기: 작업 항목의 댓글 내역 조회
부모-자식 관계: 작업 항목 간의 계층 구조 설정

프로젝트 가져오기: 조직 내에서 접근 가능한 모든 프로젝트 보기
팀 가져오기: 조직 내의 모든 팀 목록 표시
팀 구성원: 팀 구성원 정보 보기
팀 영역 경로(Area Paths): 팀에 할당된 영역 경로 조회
팀 반복(Iterations): 팀 반복/스프린트(sprint) 구성에 액세스

계획된 기능:

파이프라인 작업: 파이프라인 상태 쿼리 및 새로운 파이프라인 실행 트리거
풀 리퀘스트(Pull Request) 처리: 풀 리퀘스트 생성, 업데이트 및 검토
스프린트 관리: 스프린트 및 반복 계획 및 관리
브랜치 정책 관리: 브랜치 정책 구성 및 관리

• Python 3.10+
• 적절한 권한을 가진 Azure DevOps 계정
• Azure DevOps API 액세스를 위한 필요한 범위(scopes)를 가진 개인 액세스 토큰 (Personal Access Token, PAT)

# 저장소 복제
git clone https://github.com/Vortiago/mcp-azure-devops.git
cd mcp-azure-devops
...

프로젝트 루트에 다음과 같은 변수들을 포함하는 .env 파일을 생성하세요:

AZURE_DEVOPS_PAT=your_personal_access_token
AZURE_DEVOPS_ORGANIZATION_URL=https://your-organization.visualstudio.com 또는 https://dev.azure.com/your-organisation

참고: Azure DevOps 조직의 전체 URL을 제공해야 합니다.

# MCP Inspector를 사용한 개발 모드
mcp dev src/mcp_azure_devops/server.py
# Claude Desktop에 설치
...

현재 스프린트(sprint)에서 나에게 할당된 모든 활성 버그(active bugs)를 보여줘

"Implement user authentication"이라는 제목으로 ProjectX에 사용자 스토리(user story)를 생성하고 john.doe@example.com에게 할당해줘

버그 #1234의 상태를 "Resolved"로 변경하고 수정 사항을 설명하는 댓글을 추가해줘

"ProjectX" 프로젝트의 "Core Development" 팀에 속한 모든 팀원을 보여줘

내 조직의 모든 프로젝트를 나열하고 "Development" 팀의 반복 주기(iterations)를 보여줘

프로젝트는 기능 모듈(feature modules)로 구조화되어 있으며, 각 모듈은 특정 Azure DevOps 기능을 구현합니다:

features/work_items: 작업 항목(work item) 관리 기능
features/projects: 프로젝트 관리 기능
features/teams: 팀 관리 기능
utils: 공통 유틸리티(utilities) 및 클라이언트 초기화

개발에 대한 자세한 내용은 CLAUDE.md 파일을 참조하세요.

기여(Contributions)는 언제나 환영합니다! 자유롭게 풀 리퀘스트(Pull Request)를 제출해 주세요.

이 프로젝트는 MIT 라이선스(MIT License) 하에 라이선스가 부여됩니다 - 자세한 내용은 LICENSE 파일을 참조하세요.

• MCP Python SDK로 구축됨
• Azure DevOps Python API 사용