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)
Установка
Ручная установка
- Клонируйте репозиторий:
- Установить зависимости:
- Настройте рабочий стол Claude:
- Открыть
claude_desktop_config.json
- Добавьте следующую конфигурацию MCP:
- Открыть
Аутентификация
Сервер поддерживает несколько методов аутентификации через DefaultAzureCredential:
- Переменные среды
- Управляемая идентификация
- Azure-интерфейс командной строки
- Код Visual Studio
- Интерактивный браузер
Сервер будет автоматически пробовать эти методы последовательно, пока один из них не окажется успешным.
Использование
- Закройте Claude Desktop, если он запущен (проверьте диспетчер задач)
- Запустить Claude Desktop
- В чате теперь вы можете задавать вопросы, связанные с Azure, например:
- «Можете ли вы получить все доступные учетные записи и подписки Azure?»
- «Перечислить все группы ресурсов в моей подписке»
- «Покажи мне все виртуальные машины в определенной группе ресурсов»
Пример разговора
Разработка
Структура проекта
Ключевые компоненты
- AzureMCPServer : Основной класс сервера, реализующий протокол MCP
- HandleCallTool : обрабатывает входящие запросы инструментов.
- ExecuteWithRetry : реализует логику повторных попыток для отказоустойчивых операций.
Поиск неисправностей
- Проблемы аутентификации :
- Убедитесь, что вы вошли в систему через Azure CLI (
az login
) - Проверьте переменные среды, если используете принципал-службу
- Убедитесь, что у вашей учетной записи Azure есть необходимые разрешения.
- Убедитесь, что вы вошли в систему через Azure CLI (
- Проблемы с подключением :
- Проверьте конфигурацию Claude Desktop
- Проверьте, соответствуют ли пути в файле конфигурации вашей установке.
- Убедитесь, что другие экземпляры не запущены.
- Распространенные ошибки :
NO_TENANT
: выберите арендатора с помощью инструмента «выбрать арендатора»NO_CLIENTS
: Обеспечьте правильную инициализацию и аутентификацию.CODE_EXECUTION_FAILED
: Проверьте разрешения и подключение Azure
Внося вклад
Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.
Участники
- @calclavia — Интеграция с smithery.ai
Благодарности
- Команда Клода Десктопа по внедрению MCP
- Команда Azure SDK для комплексного SDK
- Модель контекстного протокола для интеграции ИИ-сервисов
Примечание по безопасности
Эта реализация соответствует лучшим практикам безопасности Azure:
- Никаких жестко заданных учетных данных
- Реализация безопасной цепочки учетных данных
- Правильная обработка ошибок и очистка
Если у вас возникли проблемы с безопасностью или уязвимости, пожалуйста, создайте проблему.
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.
Обеспечивает взаимодействие со службами Azure на естественном языке через Claude Desktop, поддерживая управление ресурсами, обработку подписок и выбор арендаторов с безопасной аутентификацией.
- Функции
- Предпосылки
- Установка
- Аутентификация
- Использование
- Разработка
- Поиск неисправностей
- Внося вклад
- Участники
- Благодарности
- Примечание по безопасности
Related Resources
Related MCP Servers
- -securityAlicense-qualityLets you use Claude Desktop, or any MCP Client, to use natural language to accomplish things on your Cloudflare account.Last updated -8672,200TypeScriptApache 2.0
- -securityAlicense-qualityA server that enables LLMs like Claude to interact with Azure Cosmos DB databases through natural language queries, acting as a translator between AI assistants and database systems.Last updated -JavaScriptMIT License
- AsecurityAlicenseAqualityA server that enables LLMs (like Claude and VSCode Copilot) to interact with Azure Cosmos DB data through natural language queries, acting as a translator between AI assistants and your database.Last updated -3751JavaScriptMIT License
- -security-license-qualityEnables large language models to automatically report customer-facing issues with Azure resources by parsing natural language requests and submitting impact reports through the Azure Management API.Last updated -2Python