Skip to main content
Glama

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

значок кузнеца

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

Функции

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

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

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

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

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

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

Related MCP server: Azure Assistant MCP

Предпосылки

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

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

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

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

Установка

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

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

git clone https://github.com/Streen9/azure-mcp.git
cd azure-mcp
  1. Установить зависимости:

npm install
  1. Настройте рабочий стол Claude:

    • Открыть claude_desktop_config.json

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

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    },
    "azure": {
      "command": "tsx",
      "args": [
        "C:/Users/[YourUsername]/path/to/azure-mcp/src/launcher.ts"
      ]
    }
  }
}

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

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

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

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

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

  • Код Visual Studio

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

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

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

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

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

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

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

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

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

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

You: Can you get all the available Azure accounts and subscriptions?
Claude: I'll help you list all available Azure tenants and subscriptions.
[Claude will then use the Azure MCP to fetch and display the information]

Разработка

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

azure-mcp/
├── src/
│   ├── launcher.ts       # Server entry point
│   ├── AzureServer.ts    # Main MCP server implementation
│   └── LoggerService.ts  # Logging utility
├── package.json
└── README.md

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

  • 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:

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

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

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

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

Available Tools

9 tools
create-resource-groupC

Create a new resource group

Inputs: name (required), location (required), tags.

get-resource-detailsC

Get detailed information about a specific resource

Inputs: resourceId (required).

get-role-definitionsC

List available role definitions

Inputs: scope.

get-user-permissionsC

Get detailed user permissions by combining role assignments and role definitions

Inputs: scope.

list-resource-groupsB

List all resource groups in the selected subscription

Inputs: no named parameters.

list-role-assignmentsC

List role assignments for the subscription or resource group

Inputs: scope.

list-tenantsB

List all available Azure tenants

Inputs: no named parameters.

run-azure-codeC

Run Azure code

Inputs: reasoning (required), code (required), tenantId, subscriptionId.

select-tenantC

Select Azure tenant and subscription

Inputs: tenantId (required), subscriptionId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 9 tools

    Disambiguation4/5

    Most tools have distinct purposes targeting different Azure resources (resource groups, roles, tenants, code execution), but 'get-resource-details' is ambiguous—it could overlap with other specific getters if not clarified. The descriptions help differentiate, but this one tool creates minor confusion.

    Naming Consistency4/5

    Tools mostly follow a consistent verb_noun pattern (e.g., create-resource-group, list-resource-groups, get-role-definitions), with all using kebab-case. However, 'run-azure-code' deviates slightly by including 'azure' in the noun, breaking the pure resource-focused naming seen elsewhere.

    Tool Count5/5

    With 9 tools, this server is well-scoped for Azure management, covering core areas like resource groups, roles, tenants, and code execution. Each tool earns its place by addressing a specific aspect of Azure operations without being overly broad or sparse.

    Completeness4/5

    The toolset provides good coverage for Azure management, including CRUD-like operations (create/list for resource groups) and key administrative functions (roles, tenants). Minor gaps exist, such as missing update/delete for resource groups or more granular resource operations, but agents can likely work around these for common workflows.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables natural language exploration of Azure environments by generating and executing KQL queries against Azure Resource Graph. Supports multi-tenant configurations, subscription scoping, and provides direct access to Azure resource information through conversational interactions.
      8
      3
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      Enables intelligent interaction with Azure resources through natural language by translating requests into safe, auditable Azure CLI commands with plan/review workflows and direct access to 8 Azure services including Storage, Cosmos DB, Key Vault, and more.
      3
      1
      MIT