🌟 Azure MCP-сервер

Сервер Azure MCP реализует спецификацию MCP для создания бесшовного соединения между агентами ИИ и ключевыми службами Azure, такими как хранилище Azure, Cosmos DB и другими.

Обратите внимание, что этот проект находится на стадии публичного ознакомления, и его реализация может существенно измениться до момента его общедоступности.

📑 Содержание

1. 🎯 Обзор

2. 🛠️ Поддерживаемые в настоящее время инструменты

3. 🔌 Установка и начало работы

4. 🧪 Использование сервера Azure MCP

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

6. 👥 Участие в разработке Azure MCP Server

🎯 Обзор

✨ Что можно делать с помощью сервера Azure MCP?

Azure MCP Server нагружает ваших агентов контекстом Azure. Вот несколько интересных подсказок, которые вы можете попробовать:

🔍 Изучите свои ресурсы Azure

• «Список моих учетных записей хранилища Azure»

• «Покажи мне все мои базы данных Cosmos DB»

• «Какие индексы есть в моей службе поиска Azure AI «mysvc»?»

• «Список моих групп ресурсов»

• «Покажи мне таблицы в моей учетной записи хранилища»

• «Список контейнеров в моей базе данных Cosmos DB»

• «Получить сведения о моем контейнере Storage»

• «Получить базы данных Kusto в кластере 'mycluster'»

• «Выборка 10 строк из таблицы 'StormEvents' в базе данных Kusto 'db1'»

📊 Запрос и анализ

• «Запросить мою рабочую область Log Analytics»

• «Давайте выполним поиск по этому индексу по моему поисковому запросу»

⚙️ Управление конфигурацией

• «Список моих магазинов конфигурации приложений»

• «Показать мои пары ключ-значение в App Config»

🔧 Расширенные операции Azure

• «Список моих конечных точек Azure CDN»

• «Помогите мне создать приложение Azure с использованием Node.js»

🔍 Как это работает

Сервер Azure MCP обеспечивает бесшовную интеграцию между агентами ИИ и службами Azure посредством:

• 🔄 Интеллектуальная JSON-коммуникация, которую понимают агенты ИИ

• 🏗️ Команды на естественном языке, которые преобразуются в операции Azure

• 💡 Интеллектуальные подсказки параметров и автодополнение

• ⚡ Последовательная обработка ошибок, которая имеет смысл

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

Сервер Azure MCP предоставляет инструменты для взаимодействия со следующими службами Azure:

🔎 Azure AI Search (поисковая система/векторная база данных)

• Список служб поиска Azure AI

• Перечислите индексы и посмотрите на их схему и конфигурацию.

• Индексы поиска запросов

📊 Azure Cosmos DB (Базы данных NoSQL)

• Список учетных записей Cosmos DB

• Список и запрос баз данных

• Управление контейнерами и предметами

• Выполнение SQL-запросов к контейнерам

🐘 База данных Azure для PostgreSQL — гибкий сервер

• Составление списка и запросов к базам данных.

• Перечислить и получить схему для таблиц.

• Список, получение конфигурации и параметров для серверов.

🧮 Kusto (Azure Data Explorer)

• Список кластеров Kusto

• Список баз данных в кластере Kusto

• Список таблиц в базе данных Kusto

• Получить схему для таблицы Kusto

• Примеры строк из таблицы Kusto

• Запрос к базам данных Kusto с использованием KQL

💾 Хранилище Azure

• Список учетных записей хранения

• Управление контейнерами BLOB-объектов и BLOB-объектами

• Список и запрос таблиц хранения

• Получить свойства контейнера и метаданные

📈 Azure Monitor (аналитика журналов)

• Список рабочих областей Log Analytics

• Запрос журналов с использованием KQL

• Список доступных таблиц

⚙️ Конфигурация приложения Azure

• Список магазинов конфигурации приложений

• Управление парами ключ-значение

• Обработка маркированных конфигураций

• Блокировка/разблокировка настроек конфигурации

🔑 Хранилище ключей Azure

• Список, создание и получение ключей

📦 Группы ресурсов Azure

• Список групп ресурсов

🚌 Шина обслуживания Azure

• Изучите свойства и информацию о времени выполнения очередей, тем и подписок.

🔧 Расширение Azure CLI

• Выполняйте команды Azure CLI напрямую

• Поддержка всех функций Azure CLI

• Форматирование выходных данных JSON

• Кроссплатформенная совместимость

🚀 Расширение Azure Developer CLI (azd)

• Выполняйте команды Azure Developer CLI напрямую

• Поддержка обнаружения шаблонов, инициализации шаблонов, предоставления и развертывания

• Кроссплатформенная совместимость

Агенты и модели могут обнаружить и изучить лучшие практики и руководства по использованию инструмента azd MCP. Для получения дополнительной информации см. AZD Best Practices .

🛡️ Лучшие практики Azure

• Получите безопасные рекомендации по использованию Azure SDK промышленного уровня для эффективной генерации кода.

Подробную документацию по командам и примеры см. в разделе Команды Azure MCP .

🔌 Начало работы

Для установки и запуска сервера Azure MCP Server требуется Node.js. Если он у вас не установлен, следуйте инструкциям здесь .

VS Code + GitHub Copilot

Azure MCP Server предоставляет инструменты разработчика Azure SDK и Azure CLI. Его можно использовать отдельно или с расширением GitHub Copilot для Azure в VS Code. Если вы заинтересованы в широкой поддержке разработчиков в различных сценариях разработки Azure, не включенных в Azure MCP Server, например, поиск документации в Microsoft Learn, мы также рекомендуем это расширение.

Предпосылки

1. Установите стабильную или инсайдерскую версию VS Code:

   • 💫 Стабильный релиз

   • 🔮 Инсайдерский релиз

2. Установите расширения GitHub Copilot и GitHub Copilot Chat

3. Установите Node.js 20 или более позднюю версию

   • Убедитесь, что node и npm находятся в вашем пути

4. Откройте VS Code в пустой папке.

Установка

✨ Установка в один клик

Нажмите одну из этих кнопок, чтобы установить сервер Azure MCP для VS Code или VS Code Insiders.

После установки Azure MCP Server убедитесь, что вы выбрали GitHub Copilot Agent Mode и обновите список инструментов. Чтобы узнать больше о Agent Mode, посетите документацию VS Code .

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

Для пошаговой установки следуйте этим инструкциям:

1. Добавьте .vscode/mcp.json :

Установка докера

Для пошаговой установки следуйте этим инструкциям:

1. Клонировать репозиторий

2. Из корня репозитория соберите образ Docker: docker build -t azure/azuremcp .

3. Создайте файл .env с переменными среды, соответствующими одному из наборов . Например, файл .env , использующий принципал-службу, может выглядеть так:

1. Добавьте .vscode/mcp.json или обновите существующую конфигурацию MCP. Замените /full/path/to/.env на путь к вашему файлу .env .

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

🧪 Тестирование сервера Azure MCP

1. Откройте GitHub Copilot в VS Code и переключитесь в режим агента.

2. В списке инструментов вы должны увидеть Azure MCP Server.

3. Попробуйте запрос, который сообщает агенту о необходимости использовать сервер Azure MCP, например «Перечислить мои контейнеры хранилища Azure».

4. Агент должен иметь возможность использовать инструменты Azure MCP Server для выполнения вашего запроса.

🤖 Индивидуальные клиенты MCP

Вы можете легко настроить свой клиент MCP для использования сервера Azure MCP. Пусть ваш клиент запустит следующую команду и получит к ней доступ через стандартный ввод-вывод или SSE.

Использование стандартного ввода-вывода

Настройте клиент MCP для выполнения: npx -y @azure/mcp@latest server start . Для получения инструкций по использованию VS Code следуйте инструкциям в разделе Установка одним щелчком или Ручная установка .

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

1. Откройте окно терминала и выполните: npx -y @azure/mcp@latest server start --transport sse

2. Сервер запускается и размещается по адресу: http://localhost:5008 . Чтобы использовать другой порт, добавьте --port {YOUR-PORT-NUMBER} .

3. Откройте клиент MCP и добавьте значение конфигурации SSE. Это может отличаться в разных клиентах MCP. В VS Code это будет выглядеть так:

   { "servers": { "Azure MCP Server": { "type": "sse", "url": "http://localhost:5008/sse" } } }

Скоро появятся новые комплексные руководства для клиентов/агентов MCP!

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

Информацию о распространенных проблемах и ведении журнала см. в руководстве по устранению неполадок .

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

Azure MCP Server легко интегрируется с механизмами аутентификации вашей операционной системы хоста, что делает его очень простым для начала работы! Мы используем Azure Identity под капотом через DefaultAzureCredential , который пробует эти учетные данные в следующем порядке:

1. Переменные среды ( EnvironmentCredential ) — идеально подходят для конвейеров CI/CD

2. Общий кэш токенов ( SharedTokenCacheCredential ) — использует кэшированные токены из других инструментов.

3. Visual Studio ( VisualStudioCredential ) — использует ваши учетные данные Visual Studio.

4. Azure CLI ( AzureCliCredential ) — использует существующий логин Azure CLI.

5. Azure PowerShell ( AzurePowerShellCredential ) — использует ваш логин Az PowerShell

6. Azure Developer CLI ( AzureDeveloperCliCredential ) — использует ваш логин azd

7. Интерактивный браузер ( InteractiveBrowserCredential ) — при необходимости возвращается к входу через браузер.

Если вы уже вошли в систему любым из этих методов, сервер Azure MCP автоматически будет использовать эти учетные данные. Убедитесь, что у вас есть правильные разрешения на авторизацию в Azure (например, доступ на чтение к вашей учетной записи хранилища) через RBAC (управление доступом на основе ролей). Чтобы узнать больше о системе авторизации RBAC Azure, перейдите по этой ссылке .

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

Производственные полномочия

По умолчанию Azure MCP Server исключает производственные учетные данные, такие как Managed Identity и Workload Identity. Чтобы включить эти учетные данные, задайте переменную среды:

Это полезно при работе в службах Azure, где вы хотите использовать управляемые удостоверения.

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

Ваши учетные данные всегда надежно обрабатываются с помощью официального пакета SDK Azure Identity — мы никогда не храним и не управляем токенами напрямую .

MCP как явление является очень новым и передовым. Как и в случае со всеми новыми технологическими стандартами, рассмотрите возможность проведения проверки безопасности, чтобы убедиться, что все системы, которые интегрируются с серверами MCP, соответствуют всем правилам и стандартам, которых должна придерживаться ваша система. Это касается не только Azure MCP Server, но и любого клиента/агента MCP, который вы решите реализовать вплоть до поставщика модели.

👥 Вклад

Мы приветствуем вклад в Azure MCP Server! Независимо от того, исправляете ли вы ошибки, добавляете новые функции или улучшаете документацию, ваш вклад приветствуется.

Пожалуйста, ознакомьтесь с нашим Руководством по внесению вклада , где вы найдете рекомендации по следующим вопросам:

• 🛠️ Настройка среды разработки

• ✨ Добавление новых команд

• 📝 Требования к стилю кода и тестированию

• 🔄 Создание запросов на извлечение

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

Этот проект принял Кодекс поведения Microsoft Open Source . Для получения дополнительной информации см. раздел FAQ Кодекса поведения или свяжитесь с opencode@microsoft.com с любыми дополнительными вопросами или комментариями.