项目简介
'advanced-vscode-extension' 是一个用于在VS Code中操作Julia Pluto笔记本的扩展。它包含一个内建的MCP (Model Context Protocol) 服务器,允许AI助手(如Claude Desktop和GitHub Copilot)通过标准化协议与Pluto笔记本环境进行上下文信息获取和功能调用,从而增强AI的代码理解、生成和执行能力。
主要功能点
- Pluto笔记本集成: 在VS Code中直接编辑和运行Pluto笔记本,支持'.pluto.jl'和'.dyad.jl'文件。
- AI助手交互: 提供HTTP/SSE基础的MCP服务器,供AI助手通过JSON-RPC协议调用Pluto环境功能。
- Julia代码执行: 支持在笔记本中以及通过交互式终端实时执行Julia代码,并渲染HTML、图像、图表、Markdown等富文本输出。
- 笔记本管理: 允许AI助手通过MCP协议打开、创建、编辑、读取和执行笔记本中的单元格,甚至进行临时代码执行而不在笔记本中创建持久化单元格。
- 会话共享: VS Code扩展与MCP客户端共享同一个Pluto服务器连接,确保状态一致性。
- 能力声明: MCP服务器向客户端声明其支持的工具,让AI助手知道可以执行哪些操作,例如启动/停止Pluto服务器、操作笔记本单元格等。
安装步骤
- 安装Julia: 确保你的系统上已安装Julia,并且其可执行文件位于系统的PATH环境变量中。
- 安装Pluto.jl包: 在Julia环境中运行以下命令安装Pluto包:
using Pkg Pkg.add("Pluto") - 安装VS Code扩展: 在VS Code中搜索并安装"Pluto Notebook"扩展。
- 启动Pluto服务器和MCP服务器: 默认情况下,当你打开一个'.pluto.jl'或'.dyad.jl'文件时,扩展会自动启动Pluto服务器和MCP服务器。你也可以通过VS Code命令面板手动启动或停止它们(例如,'Pluto: Start MCP Server')。
服务器配置(供MCP客户端参考)
MCP服务器默认在 'http://localhost:3100' 上提供服务。你的MCP客户端(如Claude Desktop或GitHub Copilot)需要配置此服务器。以下是配置示例:
-
对于Claude Desktop (.mcp.json):
{ "mcpServers": { "pluto-notebook": { "url": "http://localhost:3100/mcp", "type": "sse" } } }- 'pluto-notebook': 服务器名称,可自定义。
- 'url': MCP服务器的SSE连接URL。
- 'type': 连接类型,这里是"sse"。
-
对于GitHub Copilot (mcp.json):
{ "servers": { "pluto-notebook": { "url": "http://localhost:3100/mcp", "type": "http" } }, "inputs": [] }- 'pluto-notebook': 服务器名称,可自定义。
- 'url': MCP服务器的HTTP连接URL。
- 'type': 连接类型,这里是"http"。
你也可以在VS Code中运行命令 'Pluto: Create MCP Config (Claude or Copilot)' 来生成这些配置文件。
基本使用方法
- 在VS Code中打开一个Pluto笔记本文件。
- 确保MCP服务器已运行 (默认会自动启动)。
- 在你的AI助手(如Claude Desktop或GitHub Copilot)中,根据上述配置信息连接到该MCP服务器。
- AI助手现在可以使用MCP服务器提供的工具来查询笔记本状态、执行Julia代码、管理单元格或获取Pluto基础知识指南。例如,AI可以调用'execute_code'工具执行Julia代码,或调用'list_notebooks'工具获取当前打开的笔记本列表。
信息
分类
开发者工具