Azure DevOps 온-프레미스 배포 MCP 서버

Azure DevOps Server 2022(온-프레미스 배포) 용 Model Context Protocol(MCP) 서버입니다. AI 어시스턴트가 30개의 도구를 통해 온-프레미스 Azure DevOps Server와 상호작용할 수 있게 해줍니다.

설정

MCP를 지원하는 클라이언트 설정 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "azure-devops-onprem": {
      "command": "npx",
      "args": ["-y", "@wootz/ado-onprem-mcp"],
      "env": {
        "ADO_SERVER_URL": "https://tfs.company.com/DefaultCollection",
        "ADO_PAT_TOKEN": "your-pat-token-here",
        "ADO_PROJECT": "MyProject", // 可選，設定後所有工具預設操作此專案
        "NODE_TLS_REJECT_UNAUTHORIZED": "0" // 使用自簽憑證
      }
    }
  }
}

환경 변수 설명:

• ADO_SERVER_URL: 필수, 전체 컬렉션 경로(예: https://tfs.company.com/DefaultCollection)

• ADO_PAT_TOKEN: 필수, 개인 액세스 토큰

• ADO_PROJECT: 선택, 기본 프로젝트 이름. 설정하면 모든 도구가 project 매개변수를 지정하지 않았을 때 자동으로 이 프로젝트를 사용합니다. 동일한 프로젝트 이름을 명시적으로 전달하면 정상적으로 실행되며, 다른 프로젝트를 전달하면 차단됩니다. WIQL 쿼리에 [System.TeamProject] 조건이 없으면 이 조건이 자동으로 주입되어 프로젝트 간 데이터 조회를 방지합니다.

• NODE_TLS_REJECT_UNAUTHORIZED: 필수, 자체 서명 인증서 지원을 위해 "0"으로 설정(온-프레미스 배포 환경에서 흔함)

⚠️ 보안 경고: NODE_TLS_REJECT_UNAUTHORIZED=0은 SSL 인증서 검증을 건너뜁니다. 내부 네트워크의 온-프레미스 배포 환경에서만 사용하세요. 공개 네트워크 환경에서는 사용하지 마십시오.

개인 액세스 토큰(PAT) 생성

1. Azure DevOps Server로 이동: https://your-server/DefaultCollection

2. 오른쪽 상단의 프로필 아이콘 클릭 → 보안 → 개인 액세스 토큰

3. 새 토큰을 만들고 다음 범위를 설정하세요:

   • 코드: 읽기 및 쓰기(Pull Request 및 Git 작업용)

   • 작업 항목: 읽기 및 쓰기(작업 항목 작업용)

   • 프로젝트 및 팀: 읽기(프로젝트 및 Sprint 정보용)

   • 빌드: 읽기 및 실행(Build/Pipeline 작업용)

Related MCP server: Azure DevOps MCP Server

시스템 요구 사항

• Node.js >= 20.0.0

• Azure DevOps Server 2022(온-프레미스 배포 버전)

• 유효한 개인 액세스 토큰(PAT)

사용 가능한 도구

Core(1개 도구)

• mcp_ado_core_list_projects - 모든 프로젝트 나열

Work Items(11개 도구)

• mcp_ado_work_items_get - 작업 항목 상세 정보 가져오기

• mcp_ado_work_items_create - 새 작업 항목 만들기

• mcp_ado_work_items_update - 작업 항목 업데이트

• mcp_ado_work_items_delete - 작업 항목 삭제

• mcp_ado_work_items_query_by_wiql - 작업 항목 조회(WIQL)

• mcp_ado_work_items_add_comment - 주석 추가

• mcp_ado_work_items_get_comments - 주석 가져오기

• mcp_ado_work_items_add_link - 작업 항목 링크 추가

• mcp_ado_work_items_get_updates - 수정 이력 가져오기

• mcp_ado_work_items_batch_get - 작업 항목 일괄 가져오기

• mcp_ado_work_items_batch_create - 작업 항목 일괄 만들기(같은 배치 내 부모-자식 계층 지원)

Repositories(10개 도구)

Pull Requests

• mcp_ado_repos_list_pull_requests - Pull Requests 나열

• mcp_ado_repos_get_pull_request - PR 상세 정보 가져오기

• mcp_ado_repos_create_pull_request - Pull Request 만들기

• mcp_ado_repos_update_pull_request - Pull Request 업데이트(상태, 제목)

• mcp_ado_repos_get_pr_threads - PR 검토 토론 가져오기

• mcp_ado_repos_create_pr_thread - PR에 검토 댓글 추가

Git

• mcp_ado_repos_list_repositories - 프로젝트 아래 모든 Repository 나열

• mcp_ado_repos_list_branches - Repository의 모든 Branch 나열

• mcp_ado_repos_get_item - 파일 내용 가져오기(특정 Branch 지정 지원)

• mcp_ado_repos_get_commits - Commit 기록 가져오기(Branch / 경로 / 작성자 필터링 가능)

Builds(5개 도구)

• mcp_ado_builds_list_definitions - Build Definitions 나열(Pipeline 목록)

• mcp_ado_builds_list - Builds 나열(상태 / 결과 / Branch 필터링 지원)

• mcp_ado_builds_get - 특정 Build 상세 정보 가져오기

• mcp_ado_builds_queue - 새 Build 트리거(Queue)

• mcp_ado_builds_get_logs - Build Log 목록 또는 특정 Log 내용 가져오기

Work / Sprint(3개 도구)

• mcp_ado_work_list_iterations - Sprint / Iteration 나열(past / current / future 필터링 지원)

• mcp_ado_work_get_iteration_work_items - 지정된 Sprint 내 모든 작업 항목 가져오기

• mcp_ado_work_list_backlogs - Backlog 레벨 나열(Epics / Features / Stories)

총 30개 도구

전체 도구 정의와 매개변수 설명은 소스 코드의 src/tools/ 디렉터리를 참조하세요.

사용 예시

자연어로 AI 어시스턴트와 상호작용하여 다양한 Azure DevOps 작업을 수행할 수 있습니다:

프로젝트 및 작업 항목 조회

• "모든 프로젝트 나열"

• "작업 항목 #1234 표시"

• "MyProject에서 나에게 할당된 작업 항목 조회"

• "진행 중 상태인 모든 버그 나열"

• "최근 7일 동안 수정된 작업 항목 표시"

작업 항목 만들기 및 업데이트

• "MyProject에 제목이 '로그인 페이지 오류'인 버그 만들기"

• "제목이 '로그아웃 기능 추가'인 User Story를 만들고 john@company.com에게 할당"

• "작업 항목 #5678을 상태 '완료'로 업데이트"

• "작업 항목 #1234의 우선순위를 1로 설정"

• "작업 항목 #1234에 주석 추가: 문제 재현 확인됨"

• "제목이 '단위 테스트 보강'인 Task를 만들고 부모를 #5787로 지정"

• "Feature 하나와 그 아래 Task 3개를 한 번에 만들기"

작업 항목 연결 관리

• "작업 항목 #100을 #200에 유형 Related로 연결"

• "작업 항목 #6320을 #5787 아래에 연결"

• "작업 항목 #1234의 모든 주석 표시"

• "작업 항목 #5678의 수정 이력 보기"

• "작업 항목 #999의 모든 연결 항목 나열"

Repository 및 Git 작업

• "MyProject 아래 모든 repository 나열"

• "MainRepo의 모든 branch 나열"

• "main branch에서 src/app.ts 파일 내용 가져오기"

• "MainRepo의 최근 10개 commit 기록 표시"

• "MainRepo의 모든 활성 pull request 나열"

• "pull request #123의 상세 정보 표시"

• "feature/new-api에서 develop으로 가는 PR 만들기, 제목은 'API 엔드포인트 추가'"

• "PR #789를 상태 '완료'로 업데이트"

• "PR #456의 모든 검토 토론 가져오기"

• "PR #123에 검토 댓글 추가: async/await 사용을 권장합니다"

Build / Pipeline 작업

• "MyProject의 모든 pipeline 정의 나열"

• "MyProject에서 최근 실패한 build 표시"

• "build #456의 상세 정보 가져오기"

• "definition ID 12의 build를 main branch로 트리거"

• "build #789의 log 목록 표시"

전체 워크플로 예시

여러 작업을 연결하여 전체 워크플로를 완료할 수 있습니다:

버그 보고 및 수정:

1. "MyProject에 제목이 '로그인 페이지를 불러올 수 없음'인 버그 만들기"

2. "이 버그를 developer@company.com에게 할당"

3. "주석 추가: Chrome 브라우저에서 발생, Firefox에서는 정상"

4. "이 문제를 수정하기 위해 bugfix/login에서 main으로 가는 pull request 만들기"

5. "PR에 설명 추가: CSS 로딩 순서 문제 수정"

기능 개발 추적:

1. "User Story 만들기: 사용자 프로필 페이지 구현"

2. "Task 만들기: 프로필 UI 설계, 위 User Story에 연결"

3. "다른 Task 만들기: 프로필 API 구현, 같은 User Story에 연결"

4. "완료되면 관련 작업 항목의 상태를 모두 '완료'로 업데이트"

현재 Sprint 상태 확인:

1. "MyProject의 현재 sprint에 있는 모든 작업 항목 나열"

2. "아직 완료되지 않은 task 표시"

3. "다음 sprint의 iteration ID 표시"

개발

프로젝트 빌드

pnpm install
pnpm run build

감시 모드

pnpm run watch

테스트 실행

pnpm test

Linter 실행

pnpm run lint

프로젝트 구조

src/
├── index.ts             # CLI 入口點
├── auth.ts              # PAT 認證
├── server.ts            # MCP 伺服器設定
├── tools.ts             # 工具註冊
├── tools/
│   ├── core.ts          # 專案管理 (1 個工具)
│   ├── work-items.ts    # 工作項目 (11 個工具)
│   ├── repositories.ts  # Git 與 Pull Requests (10 個工具)
│   ├── builds.ts        # Build / Pipeline (5 個工具)
│   └── work.ts          # Sprint / Backlog (3 個工具)
├── utils.ts             # 回應輔助函式
├── logger.ts            # Winston 日誌
└── version.ts           # 版本資訊

주요 기능

• ✅ 온-프레미스 전용: Azure DevOps Server 2022 전용 설계

• ✅ 컬렉션 URL: https://{server}/{collection} 형식 지원

• ✅ PAT 인증: 개인 액세스 토큰만 사용, Azure CLI 불필요

• ✅ 경량화: 최소 의존성, 간결한 구조

• ✅ 완전한 기능: 작업 항목, Pull Request, Git, Build Pipeline 및 Sprint 계획 포함

• ✅ 계층 및 일괄 처리: 부모-자식 관계 지원, 작업 항목 트리 전체를 한 번에 생성 가능

• ✅ 간결한 응답: 장황한 identity 객체 자동 정리, fields로 필요한 필드 지정 가능

라이선스

MIT License