🪐 ✨ Jupyter MCP Server

基本能力

产品定位

Jupyter MCP Server 是一个用于与 Jupyter 笔记本交互的 MCP 服务器实现，旨在提供对 JupyterLab 中运行的笔记本的编程式访问和控制。

核心功能

1. 添加并执行代码单元格
2. 添加 Markdown 单元格
3. 与 JupyterLab 实时协作(RTC)集成

适用场景

1. 开发人员在 Jupyter 环境中进行自动化操作
2. 团队协作编辑 Jupyter 笔记本
3. 集成 Jupyter 功能到其他应用程序中

工具列表

1. add_execute_code_cell
2. 功能：在 Jupyter 笔记本中添加并执行代码单元格
3. 输入：cell_content(字符串)：要执行的代码
4. 返回：成功消息
5. add_markdown_cell
6. 功能：在 Jupyter 笔记本中添加 Markdown 单元格
7. 输入：cell_content(字符串)：Markdown 内容
8. 返回：成功消息

常见问题解答

1. 确保 JupyterLab 运行在正确的端口和 IP 上(0.0.0.0)
2. 确保 MCP 服务器配置中的端口和令牌与 JupyterLab 启动命令匹配
3. 笔记本路径应相对于启动 JupyterLab 的目录

使用教程

使用依赖

pip install jupyterlab jupyter-collaboration ipykernel

安装教程

1. 通过 Docker 构建:

docker build -t datalayer/jupyter-mcp-server .

1. 通过 Smithery 安装:

npx -y @smithery/cli install @datalayer/jupyter-mcp-server --client claude

调试方式

1. 启动 JupyterLab:

jupyter lab --port 8888 --IdentityProvider.token MY_TOKEN --ip 0.0.0.0

1. 配置 MCP 服务器(示例配置见原始 README)
2. 使用提供的工具与笔记本交互

许可证

该项目遵循 Other 开源许可条款，请参阅 Other 了解完整条款。