# MCP Data Analysis Agent

A production-ready natural-language data analysis system powered by MCP (Model Context Protocol).

## Features
- **Load & Inspect**: Load datasets in CSV, JSON, Excel, and Parquet formats.
- **Session Management**: Isolated, thread-safe, multi-dataset session tracking.
- **Security & Safety**: Path traversal prevention, file size limits, and memory guards.
- **Result Envelopes**: Structured JSON summaries returned to LLM clients.

## Installation & Running

```bash
uv venv .venv
source .venv/bin/activate
uv pip install -e .
```

Run unit tests:
```bash
pytest -v
```

## Running the MCP Server

### Method 1: Directly via Python / Virtualenv
```bash
.venv/bin/python -m data_agent.server
```

### Method 2: Connecting to Claude Desktop

On macOS, open or create your Claude Desktop configuration file at:
`~/Library/Application Support/Claude/claude_desktop_config.json`

Add the following entry:

```json
{
  "mcpServers": {
    "data-analysis-agent": {
      "command": "/Users/soham34/Projects/data-mcp/.venv/bin/python",
      "args": [
        "-m",
        "data_agent.server"
      ],
      "cwd": "/Users/soham34/Projects/data-mcp"
    }
  }
}
```

Restart Claude Desktop, and the tools (`load_dataset`, `list_sessions`, `get_dataset_info`, `preview_dataset`) will appear under the tools hammer icon.