Hybris / SAP Commerce Cloud Log MCP

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

Setup

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:

{
  "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