API VEGA

⭐ Azure DevOps MCP Server

Внимание

Мы недавно завершили полную консолидацию инструментов, что повлекло за собой переименование существующих инструментов. Пожалуйста, ознакомьтесь с документацией по Toolset для полного списка новых названий инструментов.

Если это breaking change для ваших агентов или навыков, можно временно зафиксировать версию на @azure-devops/mcp@2.8.1.

Этот проект предоставляет инструменты MCP для Azure DevOps для агентов ИИ, с опытом onboarding, ориентированным на удалённое использование, и опцией локального сервера, когда он необходим.

📄 Оглавление

Важно

Мы рекомендуем использовать Remote MCP Server вместо этого локального сервера. Он не требует установки и дает доступ к новым функциям раньше остальных.

Узнать больше

📺 Обзор

Azure DevOps MCP Server приносит контекст Azure DevOps вашим агентам. Попробуйте запросы вроде:

  • "List my ADO projects" -> "Перечислить мои ADO-проекты"
  • "List ADO Builds for 'Contoso'" -> "Перечислить ADO-сборки для 'Contoso'"
  • "List ADO Repos for 'Contoso'" -> "Перечислить ADO-репозитории для 'Contoso'"
  • "List test plans for 'Contoso'" -> "Перечислить тест-планы для 'Contoso'"
  • "List teams for project 'Contoso'" -> "Перечислить команды для проекта 'Contoso'"
  • "List iterations for project 'Contoso'" -> "Перечислить итерации проекта 'Contoso'"
  • "List my work items for project 'Contoso'" -> "Перечислить мои элементы работы для проекта 'Contoso'"
  • "List work items in current iteration for 'Contoso' project and 'Contoso Team'" -> "Перечислить элементы работы в текущей итерации проекта 'Contoso' и команды 'Contoso Team'"
  • "List all wikis in the 'Contoso' project" -> "Перечислить все wiki в проекте 'Contoso'"
  • "Create a wiki page '/Architecture/Overview' with content about system design" -> "Создать страницу wiki '/Architecture/Overview' с содержанием о системе проектирования"
  • "Update the wiki page '/Getting Started' with new onboarding instructions" -> "Обновить страницу wiki '/Getting Started' новыми инструкциями по внедрению"
  • "Get the content of the wiki page '/API/Authentication' from the Documentation wiki" -> "Получить содержимое страницы wiki '/API/Authentication' из Documentation wiki"

🏆 Ожидания

Azure DevOps MCP Server основан на инструментах, которые лаконичны, просты, целенаправлены и удобны в использовании: каждый инструмент рассчитан на конкретный сценарий. Мы сознательно избегаем создания сложных инструментов, которые пытаются сделать слишком многое. Цель — предоставить тонкий уровень абстракции над REST API, чтобы доступ к данным был понятным, а модель языка могла сосредоточиться на более сложном рассуждении.

🚀 Remote MCP Server (рекомендуется)

Полные инструкции смотрите в документации по внедрению Remote MCP Server onboarding documentation.

Со временем Remote MCP Server заменит этот локальный MCP Server. Мы продолжим поддерживать локальный сервер на данный момент, но дальнейшие инвестиции будут в первую очередь направлены на удалённый опыт.

Мы рекомендуем всем пользователям локального MCP Server начать миграцию к Remote MCP Server.

Если у вас возникают проблемы с инструментами, требуется поддержка или есть запрос на новую функциональность, можно сообщить об issue, используя Remote MCP Server issue template. Во время предварительного просмотра проблемы Remote MCP Server будет отслеживаться через этот репозиторий.

Быстрый старт с .vscode/mcp.json

Используйте эту конфигурацию для прямого подключения к удалённой конечной точке Azure DevOps через потоковый HTTP-транспорт:

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http"
    }
  },
  "inputs": []
}

См. документацию для дополнительных параметров конфигурации.

После сохранения .vscode/mcp.json запустите сервер через представление MCP в VS Code, затем введите запрос типа List ADO projects.

⚙️ Поддерживаемые инструменты

См. Available Tools для полного списка доступных удалённых инструментов.

Для полного списка локальных инструментов смотрите TOOLSET.md.

🔌 Установка Local MCP Server (опционально)

Важно

Сначала начните с Remote MCP Server. Локальный MCP Server используйте только если ваш сценарий требует именно локального stdio-набора.

Используйте этот раздел, если вам нужен именно локальный опыт сервера stdio. У большинства пользователей начните с раздела Remote MCP Server выше.

Чтобы получить наилучшее впечатление, используйте Visual Studio Code и GitHub Copilot. См. getting started documentation для использования нашего MCP Server с другими инструментами, такими как Visual Studio 2022, Codex, Claude Code, Cursor, Opencode и Kilocode.

Требования

Установка

🧨 Установка из публичного источника

Этот способ установки является самым простым для всех пользователей Visual Studio Code.

🎥 Посмотрите это быстрое видео, чтобы запуститься за меньше чем две минуты!

Шаги

В вашем проекте добавьте файл .vscode\mcp.json со следующим содержимым:

{
  "inputs": [
    {
      "id": "ado_org",
      "type": "promptString",
      "description": "Azure DevOps organization name  (e.g. 'contoso')"
    }
  ],
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "${input:ado_org}"]
    }
  }
}

🔥 Чтобы быть в курсе последних возможностей, можно использовать ночные сборки. Просто обновите конфигурацию mcp.json на использование @azure-devops/mcp@next. Вот обновлённый пример:

{
  "inputs": [
    {
      "id": "ado_org",
      "type": "promptString",
      "description": "Azure DevOps organization name  (e.g. 'contoso')"
    }
  ],
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp@next", "${input:ado_org}"]
    }
  }
}

Сохраните файл, затем нажмите 'Start'.

В чате переключитесь на Agent Mode.

Нажмите "Select Tools" и выберите доступные инструменты.

Откройте GitHub Copilot Chat и попробуйте запрос типа List ADO projects. В первый раз, когда будет выполнен инструмент ADO, браузер откроется и предложит войти в учетную запись Microsoft. Пожалуйста, убедитесь, что используете учетные данные, соответствующие выбранной организации Azure DevOps.

💥 Мы настоятельно рекомендуем создать файл .github\copilot-instructions.md в вашем проекте. Это улучшит ваш опыт использования Azure DevOps MCP Server с GitHub Copilot Chat.

Чтобы начать, просто добавьте в ваш copilot instructions файл строку: "This project uses Azure DevOps. Always check to see if the Azure DevOps MCP server has a tool relevant to the user's request"

Смотрите getting started documentation, чтобы использовать наш MCP Server с другими инструментами, такими как Visual Studio 2022, Codex, Claude Code и Cursor.

🌏 Использование доменов (локально)

Azure DevOps предоставляет обширную функциональность. В результате наш Azure DevOps MCP Server включает множество инструментов. Чтобы держать набор инструментов управляемым, не путайте модель и учитывайте ограничения клиента на загружаемые инструменты, используйте Domains для загрузки только тех областей, которые вам необходимы. Domains — это именованные группы связанных инструментов (например: core, work, work-items, repositories, wiki). Добавьте аргумент -d и имена доменов в аргументы сервера в вашем mcp.json, чтобы перечислить домены для включения.

Например, используйте "-d", "core", "work", "work-items" чтобы загрузить только инструменты, связанные с Work Item (см. пример ниже).

{
  "inputs": [
    {
      "id": "ado_org",
      "type": "promptString",
      "description": "Azure DevOps organization name  (e.g. 'contoso')"
    }
  ],
  "servers": {
    "ado_with_filtered_domains": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "${input:ado_org}", "-d", "core", "work", "work-items"]
    }
  }
}

Доступные домены: core, work, work-items, search, test-plans, repositories, wiki, pipelines, advanced-security

Мы рекомендуем всегда включать инструменты core, чтобы можно было получать информацию на уровне проекта.

По умолчанию загружаются все домены

🐥 По умолчанию проекты и команды (локально)

Можно также конфигурировать значения по умолчанию для проекта и команды Azure DevOps в .vscode/mcp.json с использованием project и team, чтобы инструменты не запрашивали выбор.

Пример .vscode/mcp.json

{
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "myorg", "--authentication", "azcli"],
      "env": {
        "ado_mcp_project": "Contoso",
        "ado_mcp_team": "Fabrikam Team"
      }
    }
  }
}

📝 Устранение неполадок

См. руководство по устранению неполадок в Troubleshooting guide для помощи с распространёнными проблемами и логированием.

🎩 Примеры и лучшие практики

Изучайте примеры запросов в нашей Examples documentation.

Для лучших практик и советов по улучшению взаимодействия с MCP Server смотрите How-To guide.

🙋‍♀️ Часто задаваемые вопросы

Для ответов на распространённые вопросы о Azure DevOps MCP Server смотрите FAQ.

📌 Вклад в проект

Мы рады волонтёрству! В период превью, пожалуйста, создавайтеissue-ы для ошибок, улучшений или документации.

См. наше Contributions Guide для:

  • 🛠️ Настройка окружения разработки

  • ✨ Добавление новых инструментов

  • 📝 Стиль кода и тестирование

  • 🔄 Процесс пулл-реквеста

⚠️ Перед созданием пулл-реквеста обязательно прочтите Contributions Guide.

🤝 Кодекс поведения

Этот проект соблюдает Microsoft Open Source Code of Conduct.

По вопросам смотрите FAQ или связывайтесь с open@microsoft.com.

📈 Статистика проекта

🏆 Зал славы

Спасибо всем участникам за вклад в этот проект! ❤️

Сгенерировано с contrib.rocks

Лицензия

Лицензировано по MIT License (MIT).

Торговые марки: Этот проект может содержать товарные знаки или логотипы Microsoft или третьих лиц. Использование товарных знаков и логотипов Microsoft должно соответствовать Guidelines по товарным знакам и брендам Microsoft. Третьесторонние товарные знаки подлежат соответствующим политикам их владельцев.