Сервер Azure DevOps MCP

Реализация сервера Model Context Protocol (MCP) для Azure DevOps, позволяющая помощникам на основе ИИ взаимодействовать с API-интерфейсами Azure DevOps через стандартизированный протокол.

Обзор

Этот сервер реализует протокол контекста модели (MCP) для Azure DevOps, позволяя помощникам ИИ, таким как Клод, безопасно взаимодействовать с ресурсами Azure DevOps. Сервер действует как мост между моделями ИИ и API Azure DevOps, предоставляя стандартизированный способ:

• Доступ и управление проектами, рабочими элементами, репозиториями и многим другим

• Создание и обновление рабочих элементов, ветвей и запросов на извлечение

• Выполняйте стандартные рабочие процессы DevOps с помощью естественного языка

• Доступ к содержимому репозитория через стандартизированные URI ресурсов

• Безопасная аутентификация и взаимодействие с ресурсами Azure DevOps

Related MCP server: Azure DevOps MCP Server

Структура сервера

Сервер структурирован вокруг Model Context Protocol (MCP) для связи с помощниками ИИ. Он предоставляет инструменты для взаимодействия с ресурсами Azure DevOps, включая:

• Проекты

• Рабочие элементы

• Репозитории

• Запросы на извлечение

• Филиалы

• Трубопроводы

Основные компоненты

• AzureDevOpsServer : основной класс сервера, который инициализирует сервер MCP и регистрирует инструменты.

• Модули функций : организованы по функциональным областям (рабочие элементы, проекты, репозитории и т. д.)

• Обработчики запросов : каждый функциональный модуль обеспечивает функции идентификации и обработки запросов.

• Обработчики инструментов : модульные функции для каждой операции Azure DevOps

• Конфигурация : Конфигурация на основе среды для URL-адреса организации, PAT и т. д.

Сервер использует архитектуру на основе функций, где каждая область функций (например, рабочие элементы, проекты, репозитории) инкапсулирована в свой собственный модуль. Это делает кодовую базу более удобной для обслуживания и более простой для расширения новыми функциями.

Начиная

Предпосылки

• Node.js (v16+)

• нпм или пряжа

• Учетная запись Azure DevOps с соответствующим доступом

• Учетные данные для аутентификации (подробности см. в Руководстве по аутентификации ):

  • Персональный токен доступа (PAT) или

  • Учетные данные Azure Identity или

  • Вход в Azure CLI

Работает с NPX

Использование с Claude Desktop/Cursor AI

Для интеграции с Claude Desktop или Cursor AI добавьте в файл конфигурации одну из следующих конфигураций.

Проверка подлинности удостоверения Azure

Убедитесь, что вы вошли в Azure CLI с помощью az login а затем добавьте следующее:

{
  "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": "azure-identity",
        "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name"
      }
    }
  }
}

Аутентификация с помощью персонального токена доступа (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"
      }
    }
  }
}

Подробные инструкции по настройке и дополнительные параметры аутентификации см. в Руководстве по аутентификации .

Методы аутентификации

Этот сервер поддерживает несколько методов аутентификации для подключения к API Azure DevOps. Подробные инструкции по настройке, примеры конфигурации и советы по устранению неполадок см. в руководстве по аутентификации .

Поддерживаемые методы аутентификации

1. Персональный токен доступа (PAT) — простая аутентификация на основе токенов

2. Azure Identity (DefaultAzureCredential) — гибкая аутентификация с использованием Azure Identity SDK

3. Azure CLI — аутентификация с использованием вашего имени входа Azure CLI

Примеры файлов конфигурации для каждого метода аутентификации доступны в каталоге примеров .

Переменные среды

Полный список переменных среды и их описания см. в Руководстве по аутентификации .

Ключевые переменные среды включают в себя:

Устранение неполадок аутентификации

Подробную информацию об устранении неполадок для каждого метода аутентификации см. в Руководстве по аутентификации .

К распространенным проблемам относятся:

• Недействительные или просроченные учетные данные

• Недостаточно прав

• Проблемы с сетевым подключением

• Ошибки конфигурации

Подробности реализации аутентификации

Технические сведения о реализации аутентификации на сервере 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 : Получить рабочий элемент по идентификатору

• create_work_item : Создать новый рабочий элемент

• update_work_item : обновить существующий рабочий элемент

• list_work_items : Список рабочих элементов проекта

• manage_work_item_link : добавление, удаление или обновление связей между рабочими элементами

Инструменты поиска

• search_code : Поиск кода в репозиториях проекта

• search_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 .

История Звезды

Лицензия

Массачусетский технологический институт