A VS Code extension for working with Julia Pluto notebooks, featuring an integrated MCP (Model Context Protocol) server for AI assistant interaction. Note that this is an advanced tool meant for power users who mostly want to stay in VSCode but still leverage Pluto's execution infrastructure without the UI.
This is a collaboration between @dr14-make and @pankgeorg, is at "experiment" quality, under heavy development and will change drastically in the future and may be abandonded without notice.
While tightly coupled with Pluto.jl, this project follows a highly experimental, different path, so please don't raise issues about this in the official Pluto.jl channels or repositories. Instead, reach out directly to the contributors above in your favourite platform!
- Notebook Interface: Edit and run Pluto notebooks directly in VS Code
- Integrated Pluto Server: Automatically manages Pluto server lifecycle
- Interactive Terminal: Execute Julia code in an integrated terminal with rich output rendering
- MCP Server: HTTP-based MCP server for AI assistants like Claude Desktop and GitHub Copilot
- Shared State: Extension and MCP clients share the same Pluto server connection
- Real-time Execution: Execute Julia code and see results immediately
- Cell Management: Create, edit, and execute notebook cells
- Ephemeral Execution: Run code without modifying notebook structure
- Rich Output: Support for HTML, images, plots, and interactive content
-
Julia: Julia must be installed and available in your PATH
-
Pluto.jl: The Pluto package should be installed in Julia
using Pkg Pkg.add("Pluto")
- Open any
.pluto.jl
file in VS Code - The extension automatically starts the Pluto server and MCP server
- Start working with your notebooks!
This extension contributes the following settings:
pluto-notebook.port
: Port number for the Pluto server (default: 1234)pluto-notebook.mcpPort
: Port number for the MCP HTTP server (default: 3100)pluto-notebook.autoStartMcpServer
: Automatically start the MCP HTTP server when the extension activates (default: true)
Pluto: Start Server
- Manually start Pluto serverPluto: Stop Server
- Stop Pluto serverPluto: Restart Server
- Restart Pluto server
Pluto: Start MCP Server
- Manually start MCP HTTP serverPluto: Stop MCP Server
- Stop MCP HTTP serverPluto: Restart MCP Server
- Restart MCP HTTP server
Pluto: Create MCP Config (Claude or Copilot)
- Create config file with interactive pickerPluto: Get MCP HTTP Server URL
- Get URL and config options
Pluto: Open Notebook in Browser
- Open the current notebook in browserPluto: Create Terminal
- Create an interactive Pluto terminal
The extension includes an MCP server that allows AI assistants to interact with your Pluto notebooks.
Run the command Pluto: Create MCP Config (Claude or Copilot)
, select "Claude Desktop", and restart Claude Desktop.
Run the command Pluto: Create MCP Config (Claude or Copilot)
, select "GitHub Copilot", and reload VS Code.
For detailed setup instructions, see the MCP documentation.
- MCP Server Guide - Complete guide for MCP server setup and usage
- Terminal Guide - Interactive terminal for executing Julia code
- Pluto Server Task Guide - VSCode task integration for Pluto server
- Development Guide - Instructions for developing and contributing to the extension
- Contributing Guide - How to contribute to the project
- Semantic Release Guide - Automated release workflow
- Changelog - Version history and release notes
The extension uses the @plutojl/rainbow
package to communicate with the Pluto server. Both the VS Code extension and the MCP server share the same PlutoManager instance, ensuring consistency and avoiding duplicate processes.
VS Code Extension ──┐
├──> Shared PlutoManager ──> Pluto Server (Julia)
MCP HTTP Server ───┘
- The extension is in active development
- Some advanced Pluto features may not be fully supported yet
See CHANGELOG.md for detailed version history.
For issues, questions, or contributions, please visit the project repository on github.
Enjoy!