🪐 ✨ Jupyter MCP Server

基本能力

产品定位

Jupyter MCP Server 是一个用于与 Jupyter 笔记本交互的 MCP 服务器实现，支持本地和远程 JupyterLab 环境。

核心功能

1. 交互式笔记本操作：支持添加和执行代码单元格、添加 Markdown 单元格。
2. 地球数据下载：支持从 NASA Earth Data 下载地球数据颗粒。
3. 实时协作：通过 Jupyter Real Time Collaboration 实现笔记本内容的实时修改和查看。

适用场景

1. 开发与调试：在 JupyterLab 环境中快速添加和执行代码或 Markdown 内容。
2. 地理空间分析：下载和处理 NASA Earth Data 的地理数据。
3. 教育与协作：支持多人实时协作编辑笔记本内容。

工具列表

1. add_execute_code_cell：添加并执行代码单元格，返回执行结果。
2. add_markdown_cell：添加 Markdown 单元格，返回成功消息。
3. download_earth_data_granules：下载 NASA Earth Data 的地球数据颗粒，返回执行结果。

常见问题解答

1. 如何启动 JupyterLab：确保安装了必要的依赖（如 jupyterlab, jupyter-collaboration, ipykernel），然后运行 jupyter lab 命令。
2. 如何配置 Claude Desktop：修改 claude_desktop_config.json 文件，确保端口和令牌与 JupyterLab 配置一致。

使用教程

使用依赖

安装必要的依赖包：

pip install jupyterlab jupyter-collaboration ipykernel
pip uninstall -y pycrdt datalayer_pycrdt
pip install datalayer_pycrdt

安装教程

启动 JupyterLab：

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

调试方式

1. 检查 JupyterLab 是否正常运行：访问 http://localhost:8888 查看 JupyterLab 界面。
2. 验证 MCP 服务器连接：确保 claude_desktop_config.json 中的配置正确。

构建与安装

构建 Docker 镜像

make build-docker

通过 Smithery 安装

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

许可证

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