mcpField
M
mcp-notebooks

mcp-notebooks

本地服务
github.com/Neuron1c开发工具076 周前更新
代码仓库

关于 mcp-notebooks

mcp-notebooks 是用于逐步执行 Notebook 代码的 MCP 服务，并在多次运行间保留内核变量，面向 LLM 辅助的探索性数据分析；README 提醒当前版本使用风险较高，并建议通过 Docker 隔离。

主要功能

  1. 01逐步执行 Notebook 代码
  2. 02在内核中跨运行保留变量
  3. 03基于 Docker 的设置方式
  4. 04支持 StdIO 和 SSE 连接

适用场景

  1. 01分步开展探索性数据分析
  2. 02在多次 Notebook 执行间复用变量
  3. 03将 Notebook 执行服务连接到 MCP 客户端

MCP 相关

它向 MCP 客户端提供 Notebook 执行能力。README 描述了 StdIO 或 SSE 连接方式，其中 SSE 选项使用 supergateway。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "notebooks": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "build"
      ]
    }
  }
}
启动命令docker run -i --rm build

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
ocibuild

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-notebooks

Notebook 执行 MCP 服务

目前的状态下使用它相当危险

原由

为什么不直接用任何其他现成的 Python 执行服务来运行代码？这个 MCP 服务允许你的大模型逐步执行代码，并以类似 EDA 的方式更快地对错误做出反应。变量会保留在内核中，可用于后续执行。

Claude 安装

听着，伙计，这可不是一行命令就能搞定、再运行点什么 Node 程序的事。为了保护你的系统免受 AI 暴君……我是说 Claude 的侵害，这真的、真的应该在 Docker 环境中运行。所以先去安装 Docker，装好再回来

欢迎回来。目前它还没有发布到 DockerHub，因此请运行以下命令：

git clone [email protected]:Neuron1c/mcp-notebooks.git
cd mcp-notebooks

docker build . -t mcp-notebooks:latest

快完成了，将以下内容添加到 your claude_desktop_config.json

标准输入输出

{
  "mcpServers": {
    "notebooks": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp-notebooks:latest"
      ]
    }
  }
}

SSE

或者手动运行

docker run -p 3001:3001 mcp-notebooks:latest

现在来配置 config.json

{
  "mcpServers": {
    "notebooks": {
      "command": "npx",
      "args": [
        "supergateway",
        "--sse",
        "http://localhost:3001/sse"
      ]
    }
  }
}

添加 Python 库

目前，项目依赖仅包含运行服务所需的最少内容。要添加更多依赖，你需要安装 poetry，等你搞定它之后（小提示：使用 pipx）

uv add your-package

建议添加的包

  • numpy
  • pandas
  • scikit-learn
  • matplotlib
  • seaborn

我发现 AI 在向你展示内容时，真的很喜欢使用绘图库

待办事项

  • 查看 Notebook
  • 进一步对环境进行沙箱隔离
  • 设计一种数据导入方案（Kedro catalog？）
  • 依赖注入（或者干脆让用户自行拉取并构建容器）

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。