# @mihnea.dev/zeppelin-mcp

MCP (Model Context Protocol) server for Apache Zeppelin. Gives Claude Code direct access to the Zeppelin REST API for AI-assisted data engineering workflows.

## Install

```bash
npm install -g @mihnea.dev/zeppelin-mcp
```

## Claude Code Setup

Add to `~/.claude.json`:

```json
{
  "mcpServers": {
    "zeppelin": {
      "command": "zeppelin-mcp",
      "env": {
        "ZEPPELIN_URL": "https://your-zeppelin-instance",
        "SOCKS5_PROXY": ""
      }
    }
  }
}
```

Or run directly with npx (no install needed):

```json
{
  "mcpServers": {
    "zeppelin": {
      "command": "npx",
      "args": ["-y", "@mihnea.dev/zeppelin-mcp"],
      "env": {
        "ZEPPELIN_URL": "https://your-zeppelin-instance",
        "SOCKS5_PROXY": ""
      }
    }
  }
}
```

## Environment Variables

- `ZEPPELIN_URL` (required) — Base URL of the Zeppelin instance
- `SOCKS5_PROXY` (optional) — SOCKS5 proxy address for tunneled access

## Tools

| Tool | Description |
|------|-------------|
| `zeppelin_login` | Authenticate with username/password |
| `list_notebooks` | List all notebooks (IDs + paths) |
| `get_notebook` | Get notebook with all paragraphs |
| `create_notebook` | Create a new notebook |
| `delete_notebook` | Delete a notebook |
| `get_paragraph` | Read paragraph text and output |
| `update_paragraph` | Write/modify paragraph text |
| `create_paragraph` | Add a new paragraph |
| `delete_paragraph` | Remove a paragraph |
| `run_paragraph` | Execute a paragraph, return output |
| `run_all_paragraphs` | Execute all paragraphs in a notebook |
| `restart_interpreter` | Restart an interpreter (spark, python, etc.) |

## Development

```bash
git clone https://github.com/mihneamanolache/zeppelin-mcp
cd zeppelin-mcp
npm install
npm run build
```