{"report":"{\"v\":1,\"package\":\"jupyterlab-collab-mcp\",\"version\":\"0.15.0\",\"ranAt\":\"2026-11-16T11:49:39.375Z\",\"install\":{\"ok\":true,\"integrity\":\"sha512-5/P9agGy0Y8c3KIrz1vcM7iURz2ywUkr+h5xXpeqhnjjrIufmdHfhORM14KIrJhm6aZVD6Ky5105bpbuT3te1g==\",\"deps\":133,\"scripts\":[\"leveldown\"],\"bins\":[\"jupyter-mcp\"],\"license\":\"BSD-3-Clause\",\"engines\":\"node >=18.0.0\",\"repository\":\"git+https://github.com/ianhi/jupyterlab-collab-mcp.git\",\"bin\":\"jupyter-mcp\"},\"start\":{\"ok\":true,\"ms\":167,\"serverName\":\"jupyterlab-collab-mcp\",\"serverVersion\":\"0.15.0\",\"protocol\":\"2025-06-18\",\"stderr\":\"JupyterLab MCP server started. Use connect_jupyter tool with your JupyterLab URL to begin.\\n\"},\"tools\":[{\"name\":\"connect_jupyter\",\"description\":\"Connect to JupyterLab for real-time sync and kernel execution. Without connecting, tools still work by reading .ipynb files directly.\",\"params\":[\"url\"]},{\"name\":\"list_files\",\"description\":\"List files and directories. Use to discover notebooks.\",\"params\":[\"path\"]},{\"name\":\"list_notebooks\",\"description\":\"List notebooks with running kernels. Use list_files for all .ipynb files regardless of kernel state.\",\"params\":[]},{\"name\":\"list_kernels\",\"description\":\"List available kernel types (e.g., python3, ir) and running instances.\",\"params\":[]},{\"name\":\"troubleshoot\",\"description\":\"Diagnose why notebook edits may not be syncing or persisting. Reports connection/RTC health and, for a given notebook, sync state, browser peers, a forced-save result, and a disk-vs-room round-trip check that detects split-brain (wrong/second server). Use when edits don't show up in the browser or on disk.\",\"params\":[\"path\"]},{\"name\":\"save_notebook\",\"description\":\"Force a verified save of the notebook's live collaboration room to disk and report whether it persisted (success/skipped/failed). Use this to guarantee edits reach disk — NEVER edit the .ipynb file directly to 'save' it, as a direct file write is reverted by jupyter-collaboration and loses in-room edits.\",\"params\":[\"path\"]},{\"name\":\"open_notebook\",\"description\":\"Open a notebook and start a kernel. Safe to call if already open. Required before executing cells.\",\"params\":[\"path\",\"kernel_name\"]},{\"name\":\"create_notebook\",\"description\":\"Create a new notebook. Optionally open it with a kernel.\",\"params\":[\"path\",\"kernel_name\",\"open\",\"cells\"]},{\"name\":\"get_notebook_content\",\"description\":\"Read cells from a notebook. Returns source only (no outputs) by default. Set include_outputs=true to see results.\",\"params\":[\"path\",\"cell_type\",\"include_outputs\",\"output_format\",\"start_index\",\"end_index\",\"indices\",\"cell_ids\",\"max_output_chars\"]},{\"name\":\"get_notebook_outline\",\"description\":\"Condensed notebook structure: markdown headers by level + code cell previews. Use to find cell indices.\",\"params\":[\"path\"]},{\"name\":\"search_notebook\",\"description\":\"Grep through notebook cells (regex). Returns matching cells with context.\",\"params\":[\"path\",\"pattern\",\"search_in\",\"case_sensitive\",\"max_results\",\"context_lines\"]},{\"name\":\"replace_in_notebook\",\"description\":\"Search and replace across cells. Returns replacement count per cell.\",\"params\":[\"path\",\"search\",\"replace\",\"cell_type\",\"case_sensitive\",\"regex\",\"indices\",\"dry_run\"]},{\"name\":\"rename_symbol\",\"description\":\"Scope-aware Python rename across all cells. Won't rename in strings/comments.\",\"params\":[\"path\",\"cell_index\",\"line\",\"character\",\"new_name\"]},{\"name\":\"get_diagnostics\",\"description\":\"Static code diagnostics (errors, warnings) without executing. Uses LSP or Python syntax checking.\",\"params\":[\"path\",\"cell_index\",\"cell_id\"]},{\"name\":\"get_hover_info\",\"description\":\"Documentation/type info for code at a position. Uses LSP or kernel introspection.\",\"params\":[\"path\",\"cell_index\",\"line\",\"character\"]},{\"name\":\"get_user_focus\",\"description\":\"Which cell the user is editing (cursor position via awareness protocol). Returns null if no active user.\",\"params\":[\"path\"]},{\"name\":\"insert_cell\",\"description\":\"Insert a cell. Set execute=true to run it immediately and return its output — a single-call, durable alternative to execute_code (code+output are saved in the notebook and visible to the human). Supports handoff_after_ms for long runs.\",\"params\":[\"path\",\"index\",\"cell_id\",\"source\",\"cell_type\",\"execute\",\"timeout\",\"max_images\",\"include_images\",\"handoff_after_ms\",\"client_name\"]},{\"name\":\"update_cell\",\"description\":\"Update a cell's source. Set execute=true to run it after updating.\",\"params\":[\"path\",\"index\",\"cell_id\",\"source\",\"cell_type\",\"force\",\"execute\",\"timeout\",\"max_images\",\"include_images\",\"show_diff\",\"handoff_after_ms\",\"client_name\"]},{\"name\":\"batch_update_cells\",\"description\":\"Update multiple cells atomically. More efficient than repeated update_cell.\",\"params\":[\"path\",\"updates\",\"client_name\"]},{\"name\":\"batch_insert_cells\",\"description\":\"Insert multiple cells at once, applied in order. Each `index` is the literal position in the notebook as it stands at that step (after earlier inserts in this batch). For a contiguous block, pass increasing indices (e.g. 20, 21, 22) or anchor with `cell_id`. Omit index to append.\",\"params\":[\"path\",\"inserts\",\"client_name\"]},{\"name\":\"delete_cell\",\"description\":\"Delete cells. Single: index or cell_id. Batch: indices[], cell_ids[], or start_index+end_index.\",\"params\":[\"path\",\"index\",\"cell_id\",\"indices\",\"cell_ids\",\"start_index\",\"end_index\",\"force\",\"client_name\"]},{\"name\":\"change_cell_type\",\"description\":\"Convert cell type (code <-> markdown) in place.\",\"params\":[\"path\",\"index\",\"cell_id\",\"new_type\",\"force\"]},{\"name\":\"copy_cells\",\"description\":\"Copy or move cells between notebooks. Set delete_source=true to move.\",\"params\":[\"source_path\",\"dest_path\",\"start_index\",\"end_index\",\"cell_ids\",\"dest_index\",\"dest_cell_id\",\"delete_source\",\"client_name\"]},{\"name\":\"execute_cell\",\"description\":\"Execute notebook cells. Single cell: use index/cell_id. Range: add end_index. By IDs: use cell_ids[]. Skips non-code cells in range mode.\",\"params\":[\"path\",\"index\",\"cell_id\",\"end_index\",\"cell_ids\",\"timeout\",\"max_images\",\"include_images\",\"handoff_after_ms\"]},{\"name\":\"execute_code\",\"description\":\"Run throwaway code in the kernel without modifying the notebook — for quick probes whose output you don't need to keep. Output is NOT saved and only briefly retained. For anything worth keeping or showing a human, prefer insert_cell(execute=true): same single call, but code+output are saved in the notebook.\",\"params\":[\"path\",\"code\",\"timeout\",\"max_images\",\"include_images\",\"handoff_after_ms\"]},{\"name\":\"get_cell_run_output\",\"description\":\"Fetch output for a run started by execute_cell/execute_code (typically one that handed off via handoff_after_ms). Works for runs still executing AND completed runs — also the right tool to call when a <channel source=\\\"jupyter\\\"> notification fires.\",\"params\":[\"run_id\",\"kernel_id\",\"max_images\",\"include_images\"]},{\"name\":\"list_runs\",\"description\":\"List recent kernel runs (from execute_cell/execute_code) and their states (queued/running/handed_off/completed/failed), most-recent-first. Use this to discover a run_id or check whether a handed-off run is still executing vs. finished vs. evicted, instead of blindly holding an id that may be gone.\",\"params\":[\"kernel_id\",\"limit\"]},{\"name\":\"clear_outputs\",\"description\":\"Clear execution outputs. Omit index to clear all cells.\",\"params\":[\"path\",\"index\",\"cell_id\",\"force\"]},{\"name\":\"get_cell_outputs\",\"description\":\"Read cell outputs without source code. Supports single cell, range, or non-contiguous selection.\",\"params\":[\"path\",\"index\",\"end_index\",\"indices\",\"cell_ids\",\"max_images\",\"include_images\"]},{\"name\":\"filter_output\",\"description\":\"Filter cached execution output with grep/head/tail. Use after execute_cell or execute_code — avoids re-executing.\",\"params\":[\"path\",\"execution_id\",\"grep\",\"tail\",\"head\",\"max_lines\",\"max_images\",\"include_images\"]},{\"name\":\"cell_metadata\",\"description\":\"Get or set cell metadata. Omit 'metadata' to GET, provide to SET (merges, null deletes keys).\",\"params\":[\"path\",\"index\",\"end_index\",\"indices\",\"cell_ids\",\"metadata\"]},{\"name\":\"cell_tags\",\"description\":\"Add, remove, or find tags on cells. Common: 'hide-input', 'hide-output', 'parameters'.\",\"params\":[\"path\",\"action\",\"index\",\"end_index\",\"indices\",\"cell_ids\",\"tags\",\"match_all\",\"include_preview\"]},{\"name\":\"notebook_metadata\",\"description\":\"Get or set notebook-level metadata. Omit 'metadata' to GET, provide to SET.\",\"params\":[\"path\",\"metadata\"]},{\"name\":\"kernel\",\"description\":\"Kernel control: status, interrupt, or restart.\",\"params\":[\"path\",\"action\"]},{\"name\":\"kernel_variables\",\"description\":\"List or inspect kernel variables. Without 'names': lists all. With 'names': deep inspect (columns, dtypes, shapes).\",\"params\":[\"path\",\"names\",\"detail\",\"filter\",\"include_private\",\"max_variables\",\"max_items\",\"max_name_length\"]},{\"name\":\"rename_notebook\",\"description\":\"Rename a notebook file.\",\"params\":[\"path\",\"new_path\"]},{\"name\":\"diff_notebooks\",\"description\":\"Compare two notebooks cell by cell. Returns unified diff.\",\"params\":[\"path1\",\"path2\",\"include_outputs\",\"summary_only\",\"max_diffs\"]},{\"name\":\"get_cell_history\",\"description\":\"Change history for a cell: who, when, old/new content. Session-scoped.\",\"params\":[\"path\",\"cell_id\",\"limit\"]},{\"name\":\"get_notebook_changes\",\"description\":\"Changes since a version number (polling pattern). Use since_version=0 for all.\",\"params\":[\"path\",\"since_version\",\"limit\"]},{\"name\":\"recover_cell\",\"description\":\"Re-insert a deleted cell from change history. Session-scoped.\",\"params\":[\"path\",\"cell_id\",\"index\",\"client_name\"]},{\"name\":\"snapshot\",\"description\":\"Notebook snapshots: save, restore, list, or diff against current.\",\"params\":[\"path\",\"action\",\"name\",\"description\"]},{\"name\":\"cell_locks\",\"description\":\"Advisory cell locks: acquire, release, or list.\",\"params\":[\"path\",\"action\",\"cell_ids\",\"owner\",\"ttl_minutes\",\"force\"]},{\"name\":\"report_issue\",\"description\":\"Report a tool bug, hang, or suggestion about this MCP server. Logs locally and returns a structured GitHub-issue draft (title + sectioned body) for ianhi/jupyterlab-collab-mcp. This project accepts fully agent-drafted issues.\",\"params\":[\"category\",\"summary\",\"tool_name\",\"path\",\"details\"]},{\"name\":\"notebook_guide\",\"description\":\"Best practices for working with notebooks via this server. Call this FIRST when starting notebook work (or when unsure which tool to use) — returns guidance on reading, editing, executing, collaborating, and troubleshooting. Optionally pass a topic to get just one section.\",\"params\":[\"topic\"]}],\"toolsHash\":\"a4868ceaa4e07207d0011795035fa0ab2b2e688f7beac65d82707d08590045fa\",\"wrote\":[],\"callsAt\":\"2026-11-16T11:49:45.992Z\",\"calls\":[{\"tool\":\"list_files\",\"ok\":true,\"ms\":8,\"bytes\":327},{\"tool\":\"list_notebooks\",\"ok\":false,\"ms\":2,\"bytes\":0,\"error\":\"tool reported an error: Error: Not connected to JupyterLab. Use connect_jupyter tool first with your JupyterLab URL.\"},{\"tool\":\"list_kernels\",\"ok\":false,\"ms\":0,\"bytes\":0,\"error\":\"tool reported an error: Error: Not connected to JupyterLab. Use connect_jupyter tool first with your JupyterLab URL.\"},{\"tool\":\"list_runs\",\"ok\":true,\"ms\":1,\"bytes\":119},{\"tool\":\"notebook_guide\",\"ok\":true,\"ms\":0,\"bytes\":7680}],\"host\":{\"commit\":\"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c\",\"run\":\"https://github.com/itsHaddad/bragproof/actions/runs/43857070216\"},\"network\":{\"names\":[\"registry.npmjs.org\"],\"conns\":[],\"callNames\":[],\"callConns\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OjZiNjdjM2NiNDg0NDc3NDc3YTVhNzczNDUwYTUwY2QwYjczOTQ5YzAxNjk5Y2QxNThjMTcxOWEzNjBmZGY3ODAiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTM5NSIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgzMDA5MCwiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4Mjk3OTAsImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiNTUzOTgzYmUtMWZjZC00OWYzLTgyYmEtOGJlNDQ4ZTg2YzM3IiwibmJmIjoxNzk0ODI5NDkwLCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.u_eK3VSSacyJ99G_Xp_dyevBm258yhjTuyGdaXLgNZy_zjsDxWrRtfalNFvyeGKyIpJMgTnFpUwmq15ywwF1CbPI5j1WXrIcSL30NJbLO1i4F1ei6N8tA6Uq-4dBqZH-1VYe-MB7dgWnfFwElVioqZ2FcFRJHJ90lF87OKEZaD8uvmVQaMub1Xnerh_FnykbQQX92BedPFE1SeTfLnzefpPkzUeNPtCh80GBTd9Err8ZneaNU_RI9rxPPnzh4Fq6B0JTilo0DYlyr_ieZmiFA3li8HDAq8-503KGS3zda8oAEITTd97aIs1g-0QnrIPxAIt3eiGwUURuga0-byufuA"}