OpenCode Jupyter
A Visual Studio Code extension that bridges OpenCode with Jupyter notebooks via the Model Context Protocol (MCP).
Overview
This extension runs a local MCP server inside VS Code that exposes Jupyter notebook operations as MCP tools. Any MCP-compatible client (like OpenCode) can then read, edit, and execute notebook cells, query kernel variables, and more.
Prerequisites
- VS Code ^1.90.0
- Jupyter extension (
ms-toolsai.jupyter) — installed automatically as a dependency
Installation
From VS Code Marketplace
Search for "OpenCode Jupyter" in the VS Code extensions panel, or install via CLI:
code --install-extension KrisspyWang.opencode-jupyter
From VSIX
vsce package --skip-license
code --install-extension opencode-jupyter-0.1.0.vsix
Quick Start
- Install the extension and open any
.ipynb file in VS Code.
- The MCP server starts automatically on port 9123 (configurable via
opencode-jupyter.mcpPort).
- Run the command "OpenCode Jupyter: Show MCP Configuration" to get the configuration snippet.
- Add it to your
opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"jupyter-vscode": {
"type": "remote",
"url": "http://localhost:9123/sse",
"enabled": true
}
}
}
- Restart OpenCode — the tools appear automatically.
| Tool |
Description |
jupyter_list_open_notebooks |
List all currently open Jupyter notebooks with URIs and cell counts |
jupyter_get_notebook |
Get all cells, source, and outputs (optionally by notebook URI) |
jupyter_run_cell |
Execute a cell by index (optionally by notebook URI) |
jupyter_insert_cell |
Insert a new code/markdown cell at a given index |
jupyter_edit_cell |
Modify an existing cell's source (optionally by notebook URI) |
jupyter_get_variables |
Query kernel variables (optionally by notebook URI) |
jupyter_get_errors |
Get cells with error outputs (optionally by notebook URI) |
jupyter_restart_kernel |
Restart the notebook kernel (optionally by notebook URI) |
jupyter_get_kernel_status |
Check if kernel is idle or busy (optionally by notebook URI) |
Most tools accept an optional uri parameter to target a specific notebook when multiple are open.
Architecture
OpenCode (TUI/IDE)
| MCP protocol (HTTP/SSE)
v
Local MCP Server (runs inside VS Code extension on localhost:9123)
| vscode.* APIs
v
Jupyter notebook cells, outputs, kernel state (via ms-toolsai.jupyter)
The server uses HTTP + Server-Sent Events (SSE) transport with JSON-RPC 2.0 messages, following the MCP specification.
Settings
| Setting |
Default |
Description |
opencode-jupyter.mcpPort |
9123 |
Port for the local MCP server |
opencode-jupyter.autoStartServer |
true |
Automatically start the server when a notebook is opened |
Commands
| Command |
Description |
| OpenCode Jupyter: Start MCP Server |
Manually start the MCP server |
| OpenCode Jupyter: Stop MCP Server |
Stop the running MCP server |
| OpenCode Jupyter: Show MCP Configuration |
Display the JSON snippet for opencode.json |
Development
npm run compile — compile TypeScriptnpm run watch — watch mode and recompilenpm run lint — run ESLint
References
License
MIT
