MCP 문서 관리

메뉴

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 서버는 중요한 개발 및 프로젝트 정보에 접근할 수 있으므로, 적절한 보안 조치가 필요합니다:

  1. PAT 권한을 필요한 최소 범위로 제한하세요.
  2. 민감한 작업을 수행하기 전에 확인 절차를 추가하세요.
  3. 액세스 토큰을 정기적으로 교체하고 만료 기간을 설정하세요.
  4. 서비스 계정 사용 시 적절한 권한만 부여하세요.