@akram1110/notebook-mcp 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,27 @@
+# notebook-mcp (NPM)
+
+This is an NPM wrapper for the **Python** package `notebook-mcp`.
+
+## Install
+
+```bash
+npm i -g @akram1110/notebook-mcp
+```
+
+## Run
+
+```bash
+notebook-mcp
+```
+
+## Configuration
+
+- `NOTEBOOK_MCP_PYTHON`: path to the Python executable to use
+- `NOTEBOOK_MCP_PIP_SPEC`: pip spec to install (default: `notebook-mcp`)
+- `NOTEBOOK_MCP_PIP_ARGS`: extra args passed to `pip install` (space-separated)
+
+Environment variables used by the server:
+
+- `MCP_TRANSPORT`: `stdio` (default) or `streamable-http`
+- `MCP_HOST`, `MCP_PORT`
+- `JUPYTER_BASE_URL`, `JUPYTER_TOKEN`

package/bin/notebook-mcp.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+const { launch } = require("../lib/launcher");
+
+launch(process.argv.slice(2)).catch((err) => {
+  const msg = err && err.stack ? err.stack : String(err);
+  process.stderr.write(msg + "\n");
+  process.exit(1);
+});

package/lib/launcher.js

@@ -0,0 +1,84 @@
+const { spawnSync, spawn } = require("node:child_process");
+const process = require("node:process");
+const which = require("which");
+
+function findPython() {
+  const explicit = process.env.NOTEBOOK_MCP_PYTHON;
+  if (explicit) return explicit;
+
+  const candidates = ["python", "python3", "py"]; // py is Windows launcher
+  for (const c of candidates) {
+    try {
+      const p = which.sync(c);
+      if (p) return p;
+    } catch {
+      // ignore
+    }
+  }
+  return null;
+}
+
+function runChecked(cmd, args, opts = {}) {
+  const res = spawnSync(cmd, args, { stdio: "inherit", ...opts });
+  if (res.error) throw res.error;
+  if (typeof res.status === "number" && res.status !== 0) {
+    const e = new Error(`${cmd} ${args.join(" ")} exited with code ${res.status}`);
+    e.exitCode = res.status;
+    throw e;
+  }
+}
+
+function canImportNotebookMcp(python) {
+  const res = spawnSync(python, ["-c", "import notebook_mcp"], { stdio: "ignore" });
+  return res.status === 0;
+}
+
+function ensureInstalled(python) {
+  if (canImportNotebookMcp(python)) return;
+
+  const spec = process.env.NOTEBOOK_MCP_PIP_SPEC || "notebook-mcp";
+  const extraArgs = (process.env.NOTEBOOK_MCP_PIP_ARGS || "").split(" ").filter(Boolean);
+
+  // Use module invocation so we don't rely on pip.exe being on PATH.
+  runChecked(python, ["-m", "pip", "install", "-U", spec, ...extraArgs]);
+
+  if (!canImportNotebookMcp(python)) {
+    throw new Error(
+      "Installed notebook-mcp but it is still not importable. " +
+        "Check that your Python environment is the one you expect (NOTEBOOK_MCP_PYTHON)."
+    );
+  }
+}
+
+async function launch(argv) {
+  const python = findPython();
+  if (!python) {
+    throw new Error(
+      "Python was not found on PATH. Install Python 3.11+ and ensure `python` is available, " +
+        "or set NOTEBOOK_MCP_PYTHON to the full path of your python executable."
+    );
+  }
+
+  ensureInstalled(python);
+
+  // Run as module so this works even if Scripts/ is not on PATH.
+  const child = spawn(python, ["-m", "notebook_mcp.server", ...argv], {
+    stdio: "inherit",
+    env: process.env,
+  });
+
+  return new Promise((resolve, reject) => {
+    child.on("error", reject);
+    child.on("exit", (code, signal) => {
+      if (signal) {
+        const e = new Error(`notebook-mcp exited due to signal ${signal}`);
+        e.exitCode = 1;
+        reject(e);
+        return;
+      }
+      resolve(code || 0);
+    });
+  });
+}
+
+module.exports = { launch };

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@akram1110/notebook-mcp",
+  "version": "1.0.2",
+  "description": "NPM wrapper that launches the notebook-mcp Python MCP server",
+  "license": "MIT",
+  "main": "lib/launcher.js",
+  "bin": {
+    "notebook-mcp": "bin/notebook-mcp.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "jupyter",
+    "notebook",
+    "ipynb",
+    "cli"
+  ],
+  "files": [
+    "bin/notebook-mcp.js",
+    "lib/launcher.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-org/notebook-mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/your-org/notebook-mcp/issues"
+  },
+  "homepage": "https://github.com/your-org/notebook-mcp#readme",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "which": "^4.0.0"
+  }
+}