Metadata-Version: 2.4
Name: pack-mcp-grafana
Version: 0.2.0
Summary: MCP Server para consulta de logs do Grafana via Loki API
License-Expression: MIT
Keywords: mcp,grafana,loki,logs,monitoring
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: mcp
Requires-Dist: httpx
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-asyncio; extra == "dev"
Requires-Dist: pytest-httpx; extra == "dev"
Requires-Dist: hypothesis; extra == "dev"
Requires-Dist: hypothesis[pytest]; extra == "dev"

# pack-mcp-grafana

MCP Server para consulta de logs do Grafana via Loki API com autenticação por Service Account Token.

## Instalação

```bash
pip install pack-mcp-grafana
```

## Configuração

Defina as variáveis de ambiente antes de executar:

```bash
export GRAFANA_URL="https://grafana.sua-empresa.com"
export GRAFANA_SA_TOKEN="glsa_xxxxxxxxxxxx"

# Opcional: UID do datasource Loki (default: "loki")
export GRAFANA_LOKI_DATASOURCE_UID="loki"
```

Para gerar o token: Administration → Users and access → Service Accounts → Add token (permissão Viewer).

## Uso

```bash
python -m mcp_grafana
```

Ou via entry point:

```bash
pack-mcp-grafana
```

## Ferramentas MCP

| Ferramenta | Descrição |
|---|---|
| `grafana_query_logs` | Consulta logs de um serviço via Loki |
| `grafana_list_datasources` | Lista datasources disponíveis no Grafana |
| `grafana_analyze_logs` | Analisa logs com contagens, distribuição por nível e top erros |

## Configuração no Kiro / Claude Desktop

```json
{
  "mcpServers": {
    "mcp-grafana": {
      "command": "pack-mcp-grafana",
      "env": {
        "GRAFANA_URL": "https://grafana.sua-empresa.com",
        "GRAFANA_SA_TOKEN": "glsa_xxxxxxxxxxxx"
      }
    }
  }
}
```
