Zeppelin

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

Development

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