Azure MCP Server

Servidor MCP (Model Context Protocol) desenvolvido com Node.js e Express para monitorar serviços da Azure, incluindo Virtual Machines (VMs) e Virtual Machine Scale Sets (VMSS).

Funcionalidades

Monitoramento de Virtual Machines (VMs)
Monitoramento de Virtual Machine Scale Sets (VMSS)
Obtenção de status e detalhes de recursos Azure
API RESTful com endpoints organizados
Autenticação segura com Azure via Service Principal

Pré-requisitos

Node.js 14+ instalado
Conta Azure ativa
Service Principal configurado com permissões adequadas
Subscription ID da Azure

Configuração

1. Instalação

cd azure-mcp-server npm install

2. Configurar variáveis de ambiente

Copie o arquivo .env.example para .env:

cp .env.example .env

Edite o arquivo .env com suas credenciais Azure:

# Azure Configuration AZURE_SUBSCRIPTION_ID=sua-subscription-id AZURE_TENANT_ID=seu-tenant-id AZURE_CLIENT_ID=seu-client-id AZURE_CLIENT_SECRET=seu-client-secret # Server Configuration PORT=3000 NODE_ENV=development # Resource Groups to Monitor (comma-separated) RESOURCE_GROUPS=rg-production,rg-staging

3. Criar Service Principal na Azure

az login az ad sp create-for-rbac --name "azure-mcp-server" --role "Reader" --scopes /subscriptions/{subscription-id}

Anote os valores retornados:

appId → AZURE_CLIENT_ID
password → AZURE_CLIENT_SECRET
tenant → AZURE_TENANT_ID

Uso

Iniciar o servidor

IMPORTANTE: O servidor pode iniciar mesmo sem as credenciais Azure configuradas, mas as chamadas à API falharão. Configure o arquivo .env antes de usar os endpoints da API.

Desenvolvimento (com hot-reload):

npm run dev

Produção:

npm start

Testar servidor:

npm test

O servidor estará disponível em http://localhost:3000

Ao iniciar, você verá:

✓ Azure Config: Configurado → Credenciais OK, API funcionará
✗ Azure Config: Não configurado → Configure o .env antes de usar a API

Endpoints da API

Health Check

GET /health

Verifica se o servidor está funcionando.

Informações do Serviço

GET /

Retorna informações sobre o serviço e lista de endpoints disponíveis.

Virtual Machines (VMs)

Listar todas as VMs

GET /api/vms

Listar VMs por Resource Group

GET /api/vms/resource-group/:resourceGroup

Obter detalhes de uma VM

GET /api/vms/:resourceGroup/:vmName

Obter status de uma VM

GET /api/vms/:resourceGroup/:vmName/status

Virtual Machine Scale Sets (VMSS)

Listar todos os VMSS

GET /api/vmss

Listar VMSS por Resource Group

GET /api/vmss/resource-group/:resourceGroup

Obter detalhes de um VMSS

GET /api/vmss/:resourceGroup/:vmssName

Obter status de um VMSS

GET /api/vmss/:resourceGroup/:vmssName/status

Listar instâncias de um VMSS

GET /api/vmss/:resourceGroup/:vmssName/instances

Obter view de uma instância específica

GET /api/vmss/:resourceGroup/:vmssName/instances/:instanceId

Exemplos de Uso

Listar todas as VMs

curl http://localhost:3000/api/vms

Obter status de uma VM específica

curl http://localhost:3000/api/vms/meu-resource-group/minha-vm/status

Listar instâncias de um VMSS

curl http://localhost:3000/api/vmss/meu-resource-group/meu-vmss/instances

Estrutura do Projeto

azure-mcp-server/ ├── src/ │ ├── config/ │ │ └── azure.js # Configuração de autenticação Azure │ ├── services/ │ │ ├── vmService.js # Serviço para gerenciar VMs │ │ └── vmssService.js # Serviço para gerenciar VMSS │ ├── routes/ │ │ ├── vmRoutes.js # Rotas para VMs │ │ └── vmssRoutes.js # Rotas para VMSS │ └── server.js # Servidor Express principal ├── .env.example # Exemplo de variáveis de ambiente ├── .gitignore ├── package.json └── README.md

Segurança

Nunca commite o arquivo .env com credenciais reais
Use Service Principal com princípio de menor privilégio
Em produção, considere usar Azure Key Vault para armazenar secrets
O servidor usa Helmet.js para headers de segurança HTTP

Troubleshooting

Erro de autenticação

Verifique se as credenciais no .env estão corretas e se o Service Principal tem permissões adequadas.

Timeout ao listar recursos

Aumente o timeout no cliente ou verifique a conectividade com Azure.

Resource Group não encontrado

Certifique-se de que o Resource Group existe e que o Service Principal tem acesso a ele.

Melhorias Futuras

Adicionar cache para melhorar performance
Implementar webhooks para notificações
Adicionar monitoramento de App Services
Implementar autenticação no próprio servidor
Adicionar métricas e logs estruturados
Criar dashboard web para visualização
Adicionar testes unitários e de integração

Licença

ISC

Contribuindo

Pull requests são bem-vindos. Para mudanças maiores, abra uma issue primeiro para discutir o que você gostaria de mudar.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Related Resources

GitHub Repository

Need Help?

Report Issue

Azure MCP Server

Funcionalidades

Pré-requisitos

Configuração

1. Instalação

2. Configurar variáveis de ambiente

3. Criar Service Principal na Azure

Uso

Iniciar o servidor

Endpoints da API

Health Check

Informações do Serviço

Virtual Machines (VMs)

Listar todas as VMs

Listar VMs por Resource Group

Obter detalhes de uma VM

Obter status de uma VM

Virtual Machine Scale Sets (VMSS)

Listar todos os VMSS

Listar VMSS por Resource Group

Obter detalhes de um VMSS

Obter status de um VMSS

Listar instâncias de um VMSS

Obter view de uma instância específica

Exemplos de Uso

Listar todas as VMs

Obter status de uma VM específica

Listar instâncias de um VMSS

Estrutura do Projeto

Segurança

Troubleshooting

Erro de autenticação

Timeout ao listar recursos

Resource Group não encontrado

Melhorias Futuras

Licença

Contribuindo

Related Resources

New MCP Servers

MCP directory API