remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Utilizes environment variables for configuration of organization URL, Personal Access Token, and default project settings.
Enables interaction with Git repositories in Azure DevOps, including accessing repository details and branch information.
Runs on Node.js to provide a server implementation for communicating with Azure DevOps resources via the Model Context Protocol.

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 리소스를 안전하게 인증하고 상호 작용합니다.

서버 구조

이 서버는 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) 인증

{
  "mcpServers": {
    "azureDevOps": {
      "command": "npx",
      "args": ["-y", "@tiberriver256/mcp-server-azure-devops"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization",
        "AZURE_DEVOPS_AUTH_METHOD": "pat",
        "AZURE_DEVOPS_PAT": "<YOUR_PAT>",
        "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name"
      }
    }
  }
}

자세한 구성 지침과 추가 인증 옵션은 인증 가이드를 참조하세요.

인증 방법

이 서버는 Azure DevOps API에 연결하기 위한 여러 인증 방법을 지원합니다. 자세한 설정 지침, 구성 예시 및 문제 해결 팁은 인증 가이드를 참조하세요.

지원되는 인증 방법

개인 액세스 토큰(PAT) - 간단한 토큰 기반 인증
Azure Identity(DefaultAzureCredential) - Azure Identity SDK를 사용한 유연한 인증
Azure CLI - Azure CLI 로그인을 사용한 인증

각 인증 방법에 대한 예제 구성 파일은 예제 디렉토리 에서 사용할 수 있습니다.

환경 변수

환경 변수의 전체 목록과 설명을 보려면 인증 가이드를 참조하세요.

주요 환경 변수는 다음과 같습니다.

변하기 쉬운	설명	필수의	기본
`AZURE_DEVOPS_AUTH_METHOD`	인증 방법( `pat` , `azure-identity` 또는 `azure-cli` ) - 대소문자 구분 없음	아니요	`azure-identity`
`AZURE_DEVOPS_ORG_URL`	Azure DevOps 조직의 전체 URL	예	-
`AZURE_DEVOPS_PAT`	개인 액세스 토큰(PAT 인증용)	PAT 인증만 가능	-
`AZURE_DEVOPS_DEFAULT_PROJECT`	아무것도 지정하지 않으면 기본 프로젝트가 됩니다.	아니요	-
`AZURE_DEVOPS_API_VERSION`	사용할 API 버전	아니요	최신
`AZURE_TENANT_ID`	Azure AD 테넌트 ID(서비스 주체용)	서비스 주체만 사용 가능	-
`AZURE_CLIENT_ID`	Azure AD 애플리케이션 ID(서비스 주체용)	서비스 주체만 사용 가능	-
`AZURE_CLIENT_SECRET`	Azure AD 클라이언트 비밀번호(서비스 주체용)	서비스 주체만 사용 가능	-
`LOG_LEVEL`	로깅 수준(디버그, 정보, 경고, 오류)	아니요	정보

인증 문제 해결

각 인증 방법에 대한 자세한 문제 해결 정보는 인증 가이드를 참조하세요.

일반적인 문제는 다음과 같습니다.

유효하지 않거나 만료된 자격 증명
권한이 부족합니다
네트워크 연결 문제
구성 오류

인증 구현 세부 정보

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에서 프로젝트 전체에서 작업 항목 검색

모든 도구에 대한 포괄적인 설명서는 도구 설명서를 참조하세요.

기여하다

기여를 환영합니다! 기여 지침은 CONTRIBUTING.md를 참조하세요.

스타 역사

특허

MIT

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

표준화된 프로토콜을 통해 AI 어시스턴트가 프로젝트, 작업 항목, 리포지토리, 풀 리퀘스트, 분기, 파이프라인을 포함한 Azure DevOps 리소스와 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다.

Related Resources

Reddit Discussion about this server

Azure DevOps MCP Server