Azure DevOps
Azure DevOps
Azure DevOps MCP 서버는 AI 어시스턴트가 Azure DevOps 서비스와 상호작용할 수 있도록 브리지를 제공하는 커뮤니티 서버입니다. 이 서버는 자연어 인터페이스와 Azure DevOps REST API 사이의 중개자 역할을 하여, 프로젝트 관리, 작업 항목 처리, 리포지토리 관리 등의 작업을 쉽게 수행할 수 있게 합니다.
특징
- Azure DevOps API 통합: Azure DevOps REST API와의 완벽한 통합
- 작업 항목 관리: 작업 항목 검색, 생성, 업데이트 및 조회 기능
- Git 리포지토리 접근: 코드 검색, 파일 내용 조회, 변경 사항 분석
- 프로젝트 관리: 프로젝트 목록, 팀, 세부 정보 접근
- 인증 옵션: PAT(개인 액세스 토큰) 또는 Azure Identity 기반 인증 지원
- 다양한 권한 관리: 세분화된 접근 제어 및 권한 관리
API
도구
사용자 및 조직 관리
- get_me: 인증된 사용자의 정보를 가져옵니다.
- 입력: 없음
-
출력: 사용자 ID, 표시 이름, 이메일 등의 정보
-
list_organizations: 접근 가능한 모든 조직을 나열합니다.
- 입력: 없음
- 출력: 조직 목록 및 세부 정보
프로젝트 관리
- list_projects: 조직 내 모든 프로젝트를 나열합니다.
- 입력: 필터 옵션(선택적)
-
출력: 프로젝트 목록 및 세부 정보
-
get_project_details: 프로젝트의 상세 정보를 가져옵니다.
- 입력: 프로젝트 ID 또는 이름
- 출력: 프로젝트 세부 정보(프로세스, 작업 항목 유형, 팀 등)
작업 항목 관리
- get_work_item: 특정 작업 항목의 세부 정보를 가져옵니다.
- 입력: 작업 항목 ID
-
출력: 작업 항목 세부 정보
-
create_work_item: 새 작업 항목을 생성합니다.
- 입력: 프로젝트, 작업 항목 유형, 제목, 설명 등
-
출력: 생성된 작업 항목 정보
-
update_work_item: 기존 작업 항목을 업데이트합니다.
- 입력: 작업 항목 ID, 변경할 필드 및 값
- 출력: 업데이트된 작업 항목 정보
리포지토리 관리
- list_repositories: 프로젝트 내 모든 리포지토리를 나열합니다.
- 입력: 프로젝트 ID 또는 이름
-
출력: 리포지토리 목록 및 세부 정보
-
get_repository: 특정 리포지토리의 세부 정보를 가져옵니다.
- 입력: 프로젝트 ID, 리포지토리 ID 또는 이름
-
출력: 리포지토리 세부 정보
-
get_repository_content: 리포지토리 내 파일 내용을 가져옵니다.
- 입력: 프로젝트 ID, 리포지토리 ID, 파일 경로
- 출력: 파일 내용
사용 방법
설치
# uv 사용
uv pip install mcp-azure-devops
# 또는 pip 사용
pip install mcp-azure-devops
구성
환경 변수 설정:
# Windows
set AZURE_DEVOPS_PAT=your_personal_access_token
set AZURE_DEVOPS_ORGANIZATION_URL=https://dev.azure.com/your-organization
# Linux/Mac
export AZURE_DEVOPS_PAT=your_personal_access_token
export AZURE_DEVOPS_ORGANIZATION_URL=https://dev.azure.com/your-organization
또는 .env 파일 생성:
AZURE_DEVOPS_PAT=your_personal_access_token
AZURE_DEVOPS_ORGANIZATION_URL=https://dev.azure.com/your-organization
Claude Desktop 설정 파일에 추가:
{
"mcpServers": {
"azureDevOps": {
"command": "uv",
"args": ["run", "-m", "mcp_azure_devops"],
"env": {
"AZURE_DEVOPS_PAT": "<YOUR_PAT>",
"AZURE_DEVOPS_ORGANIZATION_URL": "https://dev.azure.com/your-organization",
"AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name"
}
}
}
}
연결된 구성 요소
보안 고려사항
Azure DevOps MCP 서버는 중요한 개발 및 프로젝트 정보에 접근할 수 있으므로, 적절한 보안 조치가 필요합니다:
- PAT 권한을 필요한 최소 범위로 제한하세요.
- 민감한 작업을 수행하기 전에 확인 절차를 추가하세요.
- 액세스 토큰을 정기적으로 교체하고 만료 기간을 설정하세요.
- 서비스 계정 사용 시 적절한 권한만 부여하세요.