mcp-azure-devops

Сервер Model Context Protocol для Azure DevOps. Он позволяет MCP-совместимому клиенту (Claude Desktop, Claude Code, Cursor, Codex, …) работать с досками, репозиториями, конвейерами и проектами — со встроенным уровнем управления, который удерживает ИИ-агента в безопасных границах.

Что это даёт

• Проекты и команды — список проектов/команд/участников, изучение шаблонов процессов.

• Доски / рабочие элементы — запросы WIQL, получение рабочих элементов, создание/обновление рабочих элементов, список итераций (спринтов).

• Репозитории / пул-реквесты — список репозиториев и веток, список/просмотр PR, открытие PR.

• Конвейеры / сборки — список конвейеров и последних сборок, получение сборки, постановка запусков в очередь.

• Администрирование / процессы — список шаблонов процессов, создание проекта, удаление проекта (под защитой).

• Встроенное управление доступом — режимы доступа, раздел разрешённых проектов, защищённые проекты, контроль удаления, типизированное подтверждение для операций с высоким влиянием, dry-run и JSON-журнал аудита.

Related MCP server: Azure DevOps MCP Server

Модель безопасности и управления

Инструменты

Чтение (read-only+): list_projects, get_project, list_teams, list_team_members, list_processes, query_work_items, get_work_item, list_iterations, list_repositories, list_branches, list_pull_requests, get_pull_request, list_pipelines, list_builds, get_build

Запись (read-write+): create_work_item, update_work_item, create_pull_request, run_pipeline

Администрирование (admin): create_project, delete_project (необходим AZDO_ALLOW_DELETE + типичное confirm)

Быстрый старт — подключение к агенту

Опубликован на npm как @dockndevai/mcp-azure-devops. Запускается через npx; требует организацию и PAT. Все клиенты описаны в docs/CLIENTS.md. Все переменные — в .env.example.

Claude Code

claude mcp add azure-devops -e AZDO_ORG_URL="https://dev.azure.com/your-org" -e AZDO_PAT="your-pat" -e AZDO_MODE="read-only" -- npx -y @dockndevai/mcp-azure-devops

Claude Desktop · Cursor · Windsurf

{
  "mcpServers": {
    "azure-devops": {
      "command": "npx",
      "args": ["-y", "@dockndevai/mcp-azure-devops"],
      "env": {
        "AZDO_ORG_URL": "https://dev.azure.com/your-org",
        "AZDO_PAT": "your-pat",
        "AZDO_MODE": "read-only"
      }
    }
  }
}

Примеры запросов

• «Список активных пул-реквестов в репозитории api проекта Payments»

• «Найди рабочие элементы, назначенные на меня и всё ещё Active»

• «Покажи последние 10 сборок в проекте Web и какие из них упали»

• «Создай Bug в Payments с заголовком "Checkout 500 on retry"» (требует read-write)

Запуск из исходного кода (для разработки)

npm install
npm run build
node dist/index.js   # with the environment variables set

Разработка

npm run dev
npm test          # governance policy: modes, allowlists, delete gating, confirmation
npm run typecheck

Публикация

Включает server.json для официального реестра MCP и mcpName для проверки права владения npm. Подробности — в PUBLISHING.md.

Лицензия

MIT