项目简介

'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服务器、操作笔记本单元格等。

安装步骤

  1. 安装Julia: 确保你的系统上已安装Julia,并且其可执行文件位于系统的PATH环境变量中。
  2. 安装Pluto.jl包: 在Julia环境中运行以下命令安装Pluto包:
    using Pkg
    Pkg.add("Pluto")
  3. 安装VS Code扩展: 在VS Code中搜索并安装"Pluto Notebook"扩展。
  4. 启动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)' 来生成这些配置文件。

基本使用方法

  1. 在VS Code中打开一个Pluto笔记本文件。
  2. 确保MCP服务器已运行 (默认会自动启动)。
  3. 在你的AI助手(如Claude Desktop或GitHub Copilot)中,根据上述配置信息连接到该MCP服务器。
  4. AI助手现在可以使用MCP服务器提供的工具来查询笔记本状态、执行Julia代码、管理单元格或获取Pluto基础知识指南。例如,AI可以调用'execute_code'工具执行Julia代码,或调用'list_notebooks'工具获取当前打开的笔记本列表。

信息

分类

开发者工具