{"_id":"@vbss-ai/mcp-azure-readonly","_rev":"2-342bcf0e44c6c796c1c373e8eb019dd6","name":"@vbss-ai/mcp-azure-readonly","dist-tags":{"latest":"1.0.0"},"versions":{"0.0.0-stage":{"name":"@vbss-ai/mcp-azure-readonly","version":"0.0.0-stage","_id":"@vbss-ai/mcp-azure-readonly@0.0.0-stage","stub":true,"maintainers":[{"name":"vbss","email":"vbss-dev@outlook.com"}],"dist":{"shasum":"9a9e2584cab53f9cae79630c1124d08e9cab25d7","tarball":"https://registry.npmjs.org/@vbss-ai/mcp-azure-readonly/-/mcp-azure-readonly-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-5m6qy/Fu2jyEpw0GnyE75Jri4x4csZQH+0YrpROWUvq+gA3e6OejmfQ60p6dwAYKgLDv76MH6RMo2nIxBn0A/w==","signatures":[{"sig":"MEUCIQDVNgMyLpA3sRJktTnn5ZeMxGhaHf8xEa5H6EMIGqhroQIgICLZ6p+MzZFlQWDzwKWxDTcNyO9rI8Tt7ycOjiNA5hg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":349},"_npmUser":{"name":"vbss","email":"vbss-dev@outlook.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"1.0.0":{"_id":"@vbss-ai/mcp-azure-readonly@1.0.0","bin":{"vbss-mcp-azure-readonly":"src/index.js"},"mcp":{"label":"Azure Read-Only","toolPattern":"mcp__azure-readonly__*"},"bugs":{"url":"https://github.com/vbss-io/vbss-mcps/issues"},"dist":{"shasum":"31a8e99faa1e21210de0906cb9ac84fa494951b8","tarball":"https://registry.npmjs.org/@vbss-ai/mcp-azure-readonly/-/mcp-azure-readonly-1.0.0.tgz","fileCount":7,"integrity":"sha512-jMKazJ7Fa0p2IuUqWSSRyInDgvaxHzYfTb/CkiyYe/Ap8u54JnBnfXteUQm8q4Rm5hB7u8+9oHHIF0aJSPLJ2g==","signatures":[{"sig":"MEUCIQCAnjjUNHrmK0jK5+DlzXLpZbjHpei1yvZLvnIzvIuIoQIgGaIyoXYrlviy3SnyNcbboCJnjjR2XtkMYT0thbGHN8I=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD/iSAO4hY7FEdnlUcU9Y4ECId063z4Gc8gLq+gJu0feQIhAM/1oGw1onPpFf5bBXT+qXxrG8hgobvlZoNIIucx3e5X"}],"unpackedSize":29437},"main":"src/index.js","name":"@vbss-ai/mcp-azure-readonly","type":"module","author":{"url":"https://vbss.io/","name":"Vitor Bastos","email":"vitor@vbss.io"},"engines":{"node":">=22"},"gitHead":"6aba63f482ebb7365208c1ad2075c1de495d6ca8","license":"MIT","scripts":{"start":"node src/index.js"},"version":"1.0.0","_npmUser":{"name":"vbss","email":"vbss-dev@outlook.com"},"homepage":"https://github.com/vbss-io/vbss-mcps/tree/main/packages/azure-readonly#readme","keywords":["mcp","mcp-server","model-context-protocol","azure","resource-graph","cost-management","azure-monitor","readonly"],"repository":{"url":"git+https://github.com/vbss-io/vbss-mcps.git","type":"git","directory":"packages/azure-readonly"},"_npmVersion":"10.9.4","description":"Read-only multi-org Azure MCP server for resource inventory, costs, and metrics","directories":{},"maintainers":[{"name":"vbss","email":"vbss-dev@outlook.com"}],"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.25.0","dotenv":"^16.6.1","@azure/identity":"^4.13.3","@azure/arm-monitor":"^8.0.0","@azure/arm-resources":"^8.0.0","@azure/arm-resourcegraph":"^5.0.0","@azure/arm-subscriptions":"^5.1.1","@azure/arm-costmanagement":"^1.0.0","@modelcontextprotocol/sdk":"^1.31.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-azure-readonly_1.0.0_1791765051670_0.22475089706644935"}}},"time":{"created":"2026-10-12T00:29:56.357Z","modified":"2026-10-12T00:30:51.957Z","0.0.0-stage":"2026-10-12T00:29:56.357Z","1.0.0":"2026-10-12T00:30:51.771Z"},"description":"Read-only multi-org Azure MCP server for resource inventory, costs, and metrics","maintainers":[{"name":"vbss","email":"vbss-dev@outlook.com"}],"readme":"# Azure Readonly MCP\n\nMCP server read-only multi-org para Azure. Permite inventariar recursos, consultar custos e métricas de performance em diferentes organizações.\n\n## Uso via npx\n\nNão precisa clonar nem instalar: o cliente MCP baixa e roda o pacote com `npx`. Requer Node.js 22 ou superior.\n\nAdicione no `.mcp.json` do projeto (ou no `~/.claude.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"azure-readonly\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@vbss-ai/mcp-azure-readonly\"\n      ],\n      \"env\": {\n        \"AZURE_ORGS\": \"acme\",\n        \"AZURE_ACME_TENANT_ID\": \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n        \"AZURE_ACME_CLIENT_ID\": \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n        \"AZURE_ACME_CLIENT_SECRET\": \"your-client-secret\",\n        \"AZURE_ACME_SUBSCRIPTION_ID\": \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n        \"AZURE_ACME_LABEL\": \"Acme Corp\"\n      }\n    }\n  }\n}\n```\n\nNo Windows, use `\"command\": \"cmd\"` e `\"args\": [\"/c\", \"npx\", \"-y\", \"@vbss-ai/mcp-azure-readonly\"]`.\n\nVerifique a conexão:\n\n```bash\nclaude mcp list\n```\n\n## Configuração\n\nAs variáveis vão no `env` do cliente MCP:\n\n```env\nAZURE_ORGS=acme,globex\n\nAZURE_ACME_TENANT_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\nAZURE_ACME_CLIENT_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\nAZURE_ACME_CLIENT_SECRET=your-client-secret\nAZURE_ACME_SUBSCRIPTION_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\nAZURE_ACME_LABEL=Acme Corp\n```\n\n### Permissões do Service Principal\n\nO App Registration precisa dos seguintes roles na subscription:\n\n- **Reader** — inventário de recursos\n- **Cost Management Reader** — consulta de custos\n- **Monitoring Reader** — métricas de performance\n\n## Alternativa: usar a partir do clone\n\nPara rodar sem o npm, por exemplo para testar uma mudança no código, clone o repositório e instale as dependências:\n\n```bash\ngit clone https://github.com/vbss-io/vbss-mcps.git\ncd vbss-mcps\nnpm install\n```\n\nDepois aponte o cliente MCP para o arquivo do servidor, usando o caminho absoluto do clone:\n\n```json\n{\n  \"mcpServers\": {\n    \"azure-readonly\": {\n      \"type\": \"stdio\",\n      \"command\": \"node\",\n      \"args\": [\n        \"/caminho/para/vbss-mcps/packages/azure-readonly/src/index.js\"\n      ],\n      \"env\": {\n        \"AZURE_ORGS\": \"acme\",\n        \"AZURE_ACME_TENANT_ID\": \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n        \"AZURE_ACME_CLIENT_ID\": \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n        \"AZURE_ACME_CLIENT_SECRET\": \"your-client-secret\",\n        \"AZURE_ACME_SUBSCRIPTION_ID\": \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n        \"AZURE_ACME_LABEL\": \"Acme Corp\"\n      }\n    }\n  }\n}\n```\n\nNo Windows, use barras normais no caminho (`C:/Users/voce/vbss-mcps/...`). Se o caminho tiver espaços, edite o JSON direto em vez de usar `claude mcp add`.\n\nAs variáveis podem ficar no `env` acima ou num arquivo `.env` em `packages/azure-readonly`, que o servidor lê ao iniciar.\n\nPara conferir que a configuração carrega sem erro, rode direto no terminal. O servidor fica em silêncio esperando o cliente; `Ctrl+C` encerra.\n\n```bash\nnode packages/azure-readonly/src/index.js\n```\n\n## Tools disponíveis\n\n### Organizações e Subscriptions\n\n| Tool | Descrição |\n| ------ | ----------- |\n| `list_organizations` | Lista orgs configuradas com status de conexão |\n| `list_subscriptions` | Lista subscriptions acessíveis pelo service principal |\n\n### Inventário de Recursos\n\n| Tool | Descrição |\n| ---- | ----------- |\n| `query_resources` | Query KQL no Azure Resource Graph (inventário cross-subscription) |\n| `get_resource` | Detalhes de um recurso específico por ID |\n| `list_resource_groups` | Lista resource groups com locations e tags |\n| `list_vnets` | Lista VNets com subnets, address spaces e peerings |\n\n### Custos\n\n| Tool | Descrição |\n| ---- | ----------- |\n| `query_costs` | Query flexível de custos (agrupamento, filtros, período) |\n| `get_cost_by_resource_group` | Top N resource groups mais custosos |\n| `get_cost_by_service` | Top N serviços mais custosos |\n| `get_daily_costs` | Breakdown diário de custos |\n\n### Métricas de Performance\n\n| Tool | Descrição |\n| ---- | ----------- |\n| `list_metric_definitions` | Descobre métricas disponíveis para um recurso |\n| `query_metrics` | Consulta métricas (CPU, memória, requests, etc.) |\n\n## Custo\n\nTodas as APIs usadas são gratuitas (Resource Graph, Cost Management, ARM). A API de métricas (Monitor) é gratuita até 1M chamadas/mês por subscription.\n","readmeFilename":"README.md","homepage":"https://github.com/vbss-io/vbss-mcps/tree/main/packages/azure-readonly#readme","keywords":["mcp","mcp-server","model-context-protocol","azure","resource-graph","cost-management","azure-monitor","readonly"],"repository":{"url":"git+https://github.com/vbss-io/vbss-mcps.git","type":"git","directory":"packages/azure-readonly"},"author":{"url":"https://vbss.io/","name":"Vitor Bastos","email":"vitor@vbss.io"},"bugs":{"url":"https://github.com/vbss-io/vbss-mcps/issues"},"license":"MIT"}