MCP Notebooks

🚀 笔记本执行 MCP 服务器

本项目用于在 MCP 服务器上执行笔记本的代码运行。不过，目前该项目在其当前状态下存在较大风险。

🚀 快速开始

本项目可让您在 MCP 服务器上执行笔记本代码，并且该 MCP 服务器允许您的大语言模型（LLM）进行逐步执行代码，能以类似电子设计自动化（EDA）的方式更快地响应错误，变量会保留在内核中，可在以后的执行中使用。

✨ 主要特性

• 允许大语言模型（LLM）逐步执行代码，并以类似 EDA 的方式更快地响应错误。
• 变量保留在内核中，可在后续执行中使用。

📦 安装指南

嘿伙计，这不是一键运行命令就能完成的事情。为了保护您的系统免受 AI（这里指克劳迪娅（Claude））的影响，最好在 Docker 环境中运行此服务器。所以请先安装 Docker，然后再回来。

欢迎回来。这个镜像目前不在 DockerHub 上，因此请运行以下命令：

git clone git@github.com:Neuron1c/mcp-notebooks.git
cd mcp-notebooks

docker build . -t mcp-notebooks:latest

已经完成了一半，请在 your claude_desktop_config.json 文件中添加以下内容：

标准输入输出（StdIO）

{
  "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 安装以避免麻烦）

poetry add your-package

推荐添加的包：

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

我发现 AI 真地会尝试在展示内容时使用图形库。

📚 详细文档

待办事项（TODO）

• 查看笔记本
• 更多沙盒化环境
• 设计数据导入方案（Kedro 目录？）
• 依赖注入（或者让用户拉取和构建自己的容器）
• 切换到 uv