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.
Реализация сервера Model Context Protocol (MCP) для Azure DevOps, позволяющая помощникам на основе ИИ взаимодействовать с API-интерфейсами Azure DevOps через стандартизированный протокол.
Этот сервер реализует протокол контекста модели (MCP) для Azure DevOps, позволяя помощникам ИИ, таким как Клод, безопасно взаимодействовать с ресурсами Azure DevOps. Сервер действует как мост между моделями ИИ и API Azure DevOps, предоставляя стандартизированный способ:
Сервер структурирован вокруг Model Context Protocol (MCP) для связи с помощниками ИИ. Он предоставляет инструменты для взаимодействия с ресурсами Azure DevOps, включая:
Сервер использует архитектуру на основе функций, где каждая область функций (например, рабочие элементы, проекты, репозитории) инкапсулирована в свой собственный модуль. Это делает кодовую базу более удобной для обслуживания и более простой для расширения новыми функциями.
Для интеграции с Claude Desktop или Cursor AI добавьте в файл конфигурации одну из следующих конфигураций.
Убедитесь, что вы вошли в Azure CLI с помощью az login а затем добавьте следующее:
Подробные инструкции по настройке и дополнительные параметры аутентификации см. в Руководстве по аутентификации .
Этот сервер поддерживает несколько методов аутентификации для подключения к API Azure DevOps. Подробные инструкции по настройке, примеры конфигурации и советы по устранению неполадок см. в руководстве по аутентификации .
Примеры файлов конфигурации для каждого метода аутентификации доступны в каталоге примеров .
Полный список переменных среды и их описания см. в Руководстве по аутентификации .
Ключевые переменные среды включают в себя:
| Переменная | Описание | Необходимый | По умолчанию |
|---|---|---|---|
AZURE_DEVOPS_AUTH_METHOD | Метод аутентификации ( pat , azure-identity или azure-cli ) — без учета регистра | Нет | azure-identity |
AZURE_DEVOPS_ORG_URL | Полный URL-адрес вашей организации Azure DevOps | Да | - |
AZURE_DEVOPS_PAT | Персональный токен доступа (для аутентификации PAT) | Только с аутентификацией PAT | - |
AZURE_DEVOPS_DEFAULT_PROJECT | Проект по умолчанию, если не указан | Нет | - |
AZURE_DEVOPS_API_VERSION | Версия API для использования | Нет | Последний |
AZURE_TENANT_ID | Идентификатор клиента Azure AD (для субъектов-служб) | Только с директорами служб | - |
AZURE_CLIENT_ID | Идентификатор приложения Azure AD (для субъектов-служб) | Только с директорами служб | - |
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 : Получить рабочий элемент по идентификаторуcreate_work_item : Создать новый рабочий элементupdate_work_item : обновить существующий рабочий элементlist_work_items : Список рабочих элементов проектаmanage_work_item_link : добавление, удаление или обновление связей между рабочими элементамиsearch_code : Поиск кода в репозиториях проектаsearch_wiki : Поиск контента на страницах вики в проектеsearch_work_items : Поиск рабочих элементов по проектам в Azure DevOpslist_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 .
Массачусетский технологический институт
You must be authenticated.
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.
Сервер Model Context Protocol, который позволяет помощникам на основе ИИ взаимодействовать с ресурсами Azure DevOps, включая проекты, рабочие элементы, репозитории, запросы на извлечение, ветви и конвейеры, через стандартизированный протокол.