# Hybris / SAP Commerce Cloud Log MCP

MCP server for reading and searching SAP Commerce Cloud (CCV2) logs stored in Azure Blob Storage.

## Setup

```bash
git clone https://github.com/punitdwivedi/hybris-log-mcp.git
cd hybris-log-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env   # fill in Azure credentials
```

## Cursor config

Add to `~/.cursor/mcp.json` (or merge with existing servers). Replace `/absolute/path/to/hybris-log-mcp` with your clone path:

```json
{
  "mcpServers": {
    "hybris-logs": {
      "command": "/absolute/path/to/hybris-log-mcp/.venv/bin/python",
      "args": ["/absolute/path/to/hybris-log-mcp/sap_mcp_server.py"],
      "env": {
        "AZURE_STORAGE_ACCOUNT_NAME": "your-account-name",
        "AZURE_STORAGE_ACCOUNT_KEY": "your-account-key",
        "AZURE_STORAGE_CONTAINER": "commerce-logs-separated"
      }
    }
  }
}
```

Pass credentials via the `env` block in MCP config. A local `.env` also works as a fallback via `python-dotenv`.

## Tools

| Tool | Purpose |
|------|---------|
| `health_check` | Verify Azure container connectivity |
| `list_ccv2_logs` | List blobs under a prefix |
| `get_log_blob_info` | Blob metadata |
| `read_ccv2_log` | Download + decompress log text |
| `search_ccv2_log` | Regex search in one blob |
| `search_ccv2_logs` | Regex search across recent blobs |

## Environment

| Variable | Description |
|----------|-------------|
| `AZURE_STORAGE_ACCOUNT_NAME` | Storage account name |
| `AZURE_STORAGE_ACCOUNT_KEY` | Storage account key |
| `AZURE_STORAGE_CONTAINER` | Container (default: `commerce-logs-separated`) |
| `AZURE_STORAGE_CONNECTION_STRING` | Optional full connection string override |

## License

MIT