McpApplicationInsights 0.1.0

dotnet tool install --global McpApplicationInsights --version 0.1.0
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local McpApplicationInsights --version 0.1.0
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=McpApplicationInsights&version=0.1.0
                    
nuke :add-package McpApplicationInsights --version 0.1.0
                    

McpApplicationInsights

NuGet .NET C# MCP License

Falhas Dependências Exceções Kusto Login

Servidor MCP somente leitura para Application Insights. Quem usa escolhe a assinatura e o componente visíveis no próprio login. O pacote não escolhe ambiente sozinho.

A credencial fica na máquina (az login). O pacote não guarda segredo, assinatura nem token.

Repositório: https://github.com/SouzaMatheus-dev/mcp-applicationinsights

Escopo

Leitura de falhas de request, falhas de dependência, exceções e consulta Kusto no componente escolhido.

Criar alerta, alterar recurso ou gravar telemetria continua fora deste servidor.

Requisitos

Item Detalhe
.NET SDK 8 para desenvolver. A ferramenta instalada usa o runtime exigido pelo dotnet tool
Login az login concluído, inclusive o MFA, no tenant da assinatura
Rede HTTPS até o inventário de recursos e até a consulta de logs
Conta Acesso de leitura à assinatura e ao componente

O login do portal não vale para o CLI. Se usuario_conectado falhar, rode az login de novo.

Instalação

dotnet tool install --global McpApplicationInsights
dotnet tool update --global McpApplicationInsights

O comando instalado é mcp-applicationinsights.

No Cursor, com a ferramenta global:

{
  "mcpServers": {
    "appinsights": {
      "command": "mcp-applicationinsights"
    }
  }
}

Ou via dnx, sem instalação prévia. dnx exige SDK 10. Em máquina com SDK 8 ou 9, use a ferramenta global.

{
  "mcpServers": {
    "appinsights": {
      "command": "dnx",
      "args": ["McpApplicationInsights", "--yes"]
    }
  }
}

Configuração

Nada disso entra no repositório. Variável vazia significa o padrão.

Variável Padrão Função
AZURE_TENANT_ID login padrão do CLI Tenant usado na credencial
AZURE_SUBSCRIPTION_ID todas as assinaturas visíveis Restringe a lista e a consulta
APPINSIGHTS_RESOURCE_GROUP todos os grupos Restringe os componentes
APPINSIGHTS_MAX_ROWS 40 Teto de linhas devolvidas, de 1 a 100

Exemplo no Cursor, quando a pessoa já sabe o tenant:

{
  "mcpServers": {
    "appinsights": {
      "command": "mcp-applicationinsights",
      "env": {
        "AZURE_TENANT_ID": "",
        "AZURE_SUBSCRIPTION_ID": "",
        "APPINSIGHTS_RESOURCE_GROUP": ""
      }
    }
  }
}

Deixe o valor só na configuração local do cliente. Não commite tenant, assinatura nem token.

Uso

  1. listar_assinaturas e espere a escolha.
  2. listar_componentes com a assinatura escolhida e espere o componente.
  3. Só então consulte falhas, exceções ou Kusto.

Se a resposta vier com escolher: true, apresente as opções e pare. Não chute assinatura nem componente.

Todas as ferramentas são leitura. A janela vai de 1 a 168 horas. O padrão é 24.

Ferramenta Uso
listar_assinaturas Assinaturas do login, para a pessoa escolher
listar_componentes Componentes da assinatura escolhida
usuario_conectado Identidade do token, sem devolver o JWT
falhas_por_operacao Falhas de request, no recorte da aba de operações
falhas_de_dependencia Dependências com falha
excecoes Exceções agrupadas
amostras_falha Até 15 requests com falha de uma operação
consultar_kql Kusto de leitura no componente escolhido

consultar_kql recusa comando de controle (.drop, .set, .delete, .create, .alter, .ingest).

Desenvolvimento

dotnet test McpApplicationInsights.slnx

A publicação no NuGet dispara na tag v*. O workflow .github/workflows/publish-nuget.yml testa, empacota e envia com Trusted Publishing, na conta matneves. O passo a passo da primeira vez está em docs/publicacao-nuget.md.

Limitações

  • A consulta só começa depois da assinatura e do componente. Nome repetido em mais de uma assinatura devolve a lista, em vez de escolher sozinho.
  • Listas de inventário mostram até 100 componentes. Cada tabela de resultado respeita APPINSIGHTS_MAX_ROWS.
  • A query string de URL sai das amostras. JWT encontrado no resultado vira [jwt omitido].
  • Este pacote não cobre escrita: alerta, recurso e telemetria continuam fora daqui.

Solução de problemas

Sintoma O que fazer
Falha ao obter token Rode az login no tenant da assinatura e conclua o MFA.
escolher: true Mostre as opções e chame de novo com a assinatura e o componente escolhidos.
Nenhum componente encontrado Confira o nome em listar_componentes. O filtro por ambiente, se existir, está em AZURE_SUBSCRIPTION_ID e APPINSIGHTS_RESOURCE_GROUP.
Bloqueado: só consulta de leitura A Kusto tem comando de controle. Reescreva como leitura.
HTTP no inventário A conta não enxerga a assinatura, ou o login do CLI expirou.

Licença

MIT.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
0.1.0 125 9/30/2026