@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

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

Claude Code Setup

Add to ~/.claude.json:

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

Or run directly with npx (no install needed):

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

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