Azure DevOps MCP 서버
Azure DevOps를 위한 MCP(모델 컨텍스트 프로토콜) 서버 구현으로, AI 어시스턴트가 표준화된 프로토콜을 통해 Azure DevOps API와 상호 작용할 수 있습니다.
개요
이 서버는 Azure DevOps용 MCP(모델 컨텍스트 프로토콜)를 구현하여 Claude와 같은 AI 비서가 Azure DevOps 리소스와 안전하게 상호 작용할 수 있도록 합니다. 이 서버는 AI 모델과 Azure DevOps API를 연결하는 다리 역할을 하며, 다음과 같은 표준화된 방법을 제공합니다.
프로젝트, 작업 항목, 저장소 등에 액세스하고 관리합니다.
작업 항목, 브랜치 및 풀 리퀘스트를 생성하고 업데이트합니다.
자연어를 통해 일반적인 DevOps 워크플로 실행
표준화된 리소스 URI를 통해 저장소 콘텐츠에 액세스
Azure DevOps 리소스를 안전하게 인증하고 상호 작용합니다.
Related MCP server: Azure DevOps MCP Server
서버 구조
이 서버는 AI 어시스턴트와 통신하기 위한 모델 컨텍스트 프로토콜(MCP)을 기반으로 구성됩니다. Azure DevOps 리소스와 상호 작용하기 위한 도구를 제공하며, 여기에는 다음이 포함됩니다.
프로젝트
작업 항목
저장소
풀 리퀘스트
가지
파이프라인
핵심 구성 요소
AzureDevOpsServer : MCP 서버를 초기화하고 도구를 등록하는 메인 서버 클래스
기능 모듈 : 기능 영역(작업 항목, 프로젝트, 저장소 등)별로 정리됨
요청 핸들러 : 각 기능 모듈은 요청 식별 및 처리 기능을 제공합니다.
도구 핸들러 : 각 Azure DevOps 작업에 대한 모듈식 기능
구성 : 조직 URL, PAT 등에 대한 환경 기반 구성
이 서버는 각 기능 영역(작업 항목, 프로젝트, 저장소 등)이 자체 모듈로 캡슐화되는 기능 기반 아키텍처를 사용합니다. 이를 통해 코드베이스의 유지 관리가 용이해지고 새로운 기능으로 쉽게 확장할 수 있습니다.
시작하기
필수 조건
Node.js(v16+)
npm 또는 yarn
적절한 액세스 권한이 있는 Azure DevOps 계정
인증 자격 증명(자세한 내용은 인증 가이드 참조):
개인 액세스 토큰(PAT) 또는
Azure Identity 자격 증명 또는
Azure CLI 로그인
NPX로 실행
Claude Desktop/Cursor AI와 함께 사용
Claude Desktop 또는 Cursor AI와 통합하려면 다음 구성 중 하나를 구성 파일에 추가하세요.
Azure ID 인증
az login 으로 Azure CLI에 로그인했는지 확인한 후 다음을 추가합니다.
지엑스피1
개인 액세스 토큰(PAT) 인증
자세한 구성 지침과 추가 인증 옵션은 인증 가이드를 참조하세요.
인증 방법
이 서버는 Azure DevOps API에 연결하기 위한 여러 인증 방법을 지원합니다. 자세한 설정 지침, 구성 예시 및 문제 해결 팁은 인증 가이드를 참조하세요.
지원되는 인증 방법
개인 액세스 토큰(PAT) - 간단한 토큰 기반 인증
Azure Identity(DefaultAzureCredential) - Azure Identity SDK를 사용한 유연한 인증
Azure CLI - Azure CLI 로그인을 사용한 인증
각 인증 방법에 대한 예제 구성 파일은 예제 디렉토리 에서 사용할 수 있습니다.
환경 변수
환경 변수의 전체 목록과 설명을 보려면 인증 가이드를 참조하세요.
주요 환경 변수는 다음과 같습니다.
변하기 쉬운 | 설명 | 필수의 | 기본 |
| 인증 방법(
,
또는
) - 대소문자 구분 없음 | 아니요 |
|
| Azure DevOps 조직의 전체 URL | 예 | - |
| 개인 액세스 토큰(PAT 인증용) | PAT 인증만 가능 | - |
| 아무것도 지정하지 않으면 기본 프로젝트가 됩니다. | 아니요 | - |
| 사용할 API 버전 | 아니요 | 최신 |
| Azure AD 테넌트 ID(서비스 주체용) | 서비스 주체만 사용 가능 | - |
| Azure AD 애플리케이션 ID(서비스 주체용) | 서비스 주체만 사용 가능 | - |
| Azure AD 클라이언트 비밀번호(서비스 주체용) | 서비스 주체만 사용 가능 | - |
| 로깅 수준(디버그, 정보, 경고, 오류) | 아니요 | 정보 |
인증 문제 해결
각 인증 방법에 대한 자세한 문제 해결 정보는 인증 가이드를 참조하세요.
일반적인 문제는 다음과 같습니다.
유효하지 않거나 만료된 자격 증명
권한이 부족합니다
네트워크 연결 문제
구성 오류
인증 구현 세부 정보
Azure DevOps MCP 서버에서 인증을 구현하는 방법에 대한 기술적 세부 정보는 인증 가이드 와 src/auth 디렉터리의 소스 코드를 참조하세요.
사용 가능한 도구
Azure DevOps MCP 서버는 Azure DevOps 리소스와 상호 작용하기 위한 다양한 도구를 제공합니다. 각 도구에 대한 자세한 내용은 해당 설명서를 참조하세요.
사용자 도구
get_me: 인증된 사용자의 세부 정보(id, displayName, email)를 가져옵니다.
조직 도구
list_organizations: 접근 가능한 모든 조직을 나열합니다.
프로젝트 도구
list_projects: 조직의 모든 프로젝트를 나열합니다.get_project: 특정 프로젝트의 세부 정보를 가져옵니다.get_project_details: 프로세스, 작업 항목 유형, 팀을 포함한 프로젝트의 포괄적인 세부 정보를 가져옵니다.
저장소 도구
list_repositories: 프로젝트의 모든 저장소를 나열합니다.get_repository: 특정 저장소의 세부 정보를 가져옵니다.get_repository_details: 통계 및 참조를 포함한 저장소에 대한 자세한 정보를 가져옵니다.get_file_content: 저장소에서 파일이나 디렉토리의 내용을 가져옵니다.
작업 항목 도구
get_work_item: ID로 작업 항목을 검색합니다.create_work_item: 새로운 작업 항목을 만듭니다.update_work_item: 기존 작업 항목 업데이트list_work_items: 프로젝트의 작업 항목을 나열합니다.manage_work_item_link: 작업 항목 간 링크를 추가, 제거 또는 업데이트합니다.
검색 도구
search_code: 프로젝트의 저장소에서 코드 검색search_wiki: 프로젝트의 wiki 페이지에서 콘텐츠를 검색합니다.search_work_items: Azure DevOps에서 프로젝트 전체에서 작업 항목 검색
파이프라인 도구
list_pipelines: 프로젝트의 파이프라인을 나열합니다.get_pipeline: 특정 파이프라인의 세부 정보를 가져옵니다.trigger_pipeline: 사용자 정의 가능한 매개변수로 파이프라인 실행을 트리거합니다.
위키 도구
get_wikis: 프로젝트의 모든 위키를 나열합니다.get_wiki_page: 특정 위키 페이지의 내용을 일반 텍스트로 가져옵니다.
풀 리퀘스트 도구
create_pull_request- 새로운 풀 리퀘스트를 생성합니다list_pull_requests- 저장소의 풀 리퀘스트 나열add_pull_request_comment- 풀 리퀘스트에 댓글을 추가합니다.get_pull_request_comments- 풀 리퀘스트에서 코멘트를 가져옵니다.update_pull_request- 기존 풀 리퀘스트 업데이트(제목, 설명, 상태, 초안 상태, 검토자, 작업 항목)
모든 도구에 대한 포괄적인 설명서는 도구 설명서를 참조하세요.
기여하다
기여를 환영합니다! 기여 지침은 CONTRIBUTING.md를 참조하세요.
스타 역사
특허
MIT