Zeppelin模型上下文协议服务器

为Apache Zeppelin提供模型上下文协议(MCP)服务器,使Claude Code能够直接访问Zeppelin REST API,以支持AI辅助的数据工程工作流。

  • by mihneamanolache
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 mihneamanolache/zeppelin-mcp

使用说明

@mihnea.dev/zeppelin-mcp

Apache Zeppelin的MCP(模型上下文协议)服务器。让Claude Code直接访问Zeppelin REST API,用于人工智能辅助数据工程工作流程。

安装

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

Claude代码设置

增添 ~/.claude.json:

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

或者直接使用npx运行(无需安装):

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

环境变量

  • ZEPPELIN_URL (必填)--齐柏林飞船实例的基本URL
  • SOCKS5_PROXY (可选)--用于隧道访问的SOCKS5代理地址

工具

工具 说明
zeppelin_login 使用用户名/密码进行身份验证
list_notebooks 列出所有笔记本(ID+路径)
get_notebook 获取包含所有段落的笔记本
create_notebook 创建新笔记本
delete_notebook 删除笔记本
get_paragraph 阅读段落文本并输出
update_paragraph 编写/修改段落文本
create_paragraph 添加新段落
delete_paragraph 删除一段
run_paragraph 执行一个段落,返回输出
run_all_paragraphs 执行笔记本中的所有段落
restart_interpreter 重启解释器(spark、python等)

发展

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