Azure MCP (протокол контекста модели) для Claude Desktop

Реализация Model Context Protocol (MCP), которая позволяет Claude Desktop взаимодействовать со службами Azure. Эта интеграция позволяет Claude запрашивать и управлять ресурсами Azure напрямую через разговоры на естественном языке.

Функции

• Azure Resource Management : Интерфейс с клиентом Azure Resource Management

• Управление подписками : список и управление подписками Azure

• Управление арендаторами : список и выбор арендаторов Azure

• Автоматическая аутентификация : использует DefaultAzureCredential для гибких методов аутентификации.

• Обработка ошибок : надежная обработка ошибок с повторными попытками при временных сбоях.

• Чистое форматирование ответов : правильно отформатированные ответы, совместимые с Claude Desktop

Предпосылки

• Node.js (v18 или выше)

• Приложение Клода для рабочего стола

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

• Azure CLI (необязательно, для аутентификации на основе CLI)

Установка

Ручная установка

1. Клонируйте репозиторий:

2. Установить зависимости:

3. Настройте рабочий стол Claude:

   • Открыть claude_desktop_config.json

   • Добавьте следующую конфигурацию MCP:

Аутентификация

Сервер поддерживает несколько методов аутентификации через DefaultAzureCredential:

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

• Управляемая идентификация

• Azure-интерфейс командной строки

• Код Visual Studio

• Интерактивный браузер

Сервер будет автоматически пробовать эти методы последовательно, пока один из них не окажется успешным.

Использование

1. Закройте Claude Desktop, если он запущен (проверьте диспетчер задач)

2. Запустить Claude Desktop

3. В чате теперь вы можете задавать вопросы, связанные с Azure, например:

   • «Можете ли вы получить все доступные учетные записи и подписки Azure?»

   • «Перечислить все группы ресурсов в моей подписке»

   • «Покажи мне все виртуальные машины в определенной группе ресурсов»

Пример разговора

Разработка

Структура проекта

Ключевые компоненты

• AzureMCPServer : Основной класс сервера, реализующий протокол MCP

• HandleCallTool : обрабатывает входящие запросы инструментов.

• ExecuteWithRetry : реализует логику повторных попыток для отказоустойчивых операций.

Поиск неисправностей

1. Проблемы аутентификации :

   • Убедитесь, что вы вошли в систему через Azure CLI ( az login )

   • Проверьте переменные среды, если используете принципал-службу

   • Убедитесь, что у вашей учетной записи Azure есть необходимые разрешения.

2. Проблемы с подключением :

   • Проверьте конфигурацию Claude Desktop

   • Проверьте, соответствуют ли пути в файле конфигурации вашей установке.

   • Убедитесь, что другие экземпляры не запущены.

3. Распространенные ошибки :

   • NO_TENANT : выберите арендатора с помощью инструмента «выбрать арендатора»

   • NO_CLIENTS : Обеспечьте правильную инициализацию и аутентификацию.

   • CODE_EXECUTION_FAILED : Проверьте разрешения и подключение Azure

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

Участники

• @calclavia — Интеграция с smithery.ai

Благодарности

• Команда Клода Десктопа по внедрению MCP

• Команда Azure SDK для комплексного SDK

• Модель контекстного протокола для интеграции ИИ-сервисов

Примечание по безопасности

Эта реализация соответствует лучшим практикам безопасности Azure:

• Никаких жестко заданных учетных данных

• Реализация безопасной цепочки учетных данных

• Правильная обработка ошибок и очистка

Если у вас возникли проблемы с безопасностью или уязвимости, пожалуйста, создайте проблему.