uvx 快速安装(推荐)

September 22, 2025 · View on GitHub

{
    "mcpServers":{
        "Jupyter-MCP-Server":{
            "command": "uvx",
            "args": [
                "better-jupyter-mcp-server"
            ],
            "env": {
                "ALLOW_IMG": "true"
            },
            "transport": "stdio"
        }
    }
}

接下来在对应客户端里的MCP配置文件中添加MCP服务即可环境变量的配置详见配置文档

Cursor

在Cursor右上角打开Cursor Settings(⚙图标),选择Tool & Integrations在MCP Tools中点击New MCP Sever就会跳转到mcp.json文件,呈现的示例结果如下:

{
  "mcpServers": {
    ...(已有的MCP,若没有则为空)
  }
}

在已有的MCP后将之前已经填充完善好的JSON文件黏贴,最终的参考结果如下:

{
  "mcpServers": {
    ...(已有的MCP,若没有则为空),
    "Jupyter-MCP-Server" : {
        ...(上述具体内容)
    }
  }
}

最后保存并关闭mcp.json文件,返回查看MCP Tools中是否出现名为Jupyter-MCP-Server的MCP服务,等待片刻,如果黄灯变绿灯则表明MCP服务启动成功

Trae

在应用边侧打开AI功能管理按钮(⚙图标),选择MCP,点击手动添加中的从JSON导入,输入如下内容:

{
  "mcpServers": {
    "Jupyter-MCP-Server" : {
        ...(上述具体内容)
    }
  }
}

点击确认,打开对应的MCP服务器,查看是否连接成功

Cline

在对话底部打开Manager MCP Servers,点击设置按钮(⚙图标),选择Installed,点击Configure MCP Servers就会跳转到cline_mcp_settings.json文件,呈现的示例结果如下:

{
  "mcpServers": {
    ...(已有的MCP,若没有则为空)
  }
}

在已有的MCP后添加,(英文半角符号)(若无则无需添加),将之前已经填充完善好的JSON文件黏贴之后,最终的参考结果如下:

{
  "mcpServers": {
    ...(已有的MCP,若没有则为空),
    "Jupyter-MCP-Server" : {
        ...(上述具体内容)
    }
  }
}

最后保存并关闭cline_mcp_settings.json文件,返回查看是否出现名为Jupyter-MCP-Server的MCP服务,启动并等待片刻,如果变绿灯则表明MCP服务启动成功

Gemini CLI

可以直接在终端中输入下述命令:

gemini mcp add Jupyter-MCP-Server uvx better-jupyter-mcp-server -e ALLOW_IMG=true

或者也可以在项目中.gemini文件夹下的settings.json文件中添加如下内容:

{
    ...(已有的配置,若没有则为空),
    "mcpServers":{
        ...(已有的MCP,若没有则为空),
        "Jupyter-MCP-Server":{
            "command": "uvx",
            "args": [
                "better-jupyter-mcp-server"
            ],
            "env": {
                "ALLOW_IMG": "true"
            }
        }
    }
}

Qwen Coder

可以直接在终端中输入下述命令:

qwen mcp add Jupyter-MCP-Server uvx better-jupyter-mcp-server -e ALLOW_IMG=true

或者也可以在项目中.qwen文件夹下的settings.json文件中添加如下内容:

{
    ...(已有的配置,若没有则为空),
    "mcpServers":{
        ...(已有的MCP,若没有则为空),
        "Jupyter-MCP-Server":{
            "command": "uvx",
            "args": [
                "better-jupyter-mcp-server"
            ],
            "env": {
                "ALLOW_IMG": "true"
            }
        }
    }
}

Claude Code

可以直接在终端中输入下述命令:

claude mcp add Jupyter-MCP-Server uvx better-jupyter-mcp-server -e ALLOW_IMG=true

源代码

{
    "mcpServers":{
        "Jupyter-MCP-Server":{
            "command": "uv",
            "args": [
                "run",
                "--directory",
                "your/path/to/jupyter-mcp-server",
                "src/main.py"
            ],
            "env": {},
            "transport": "stdio"
        }
    }
}

Step1: 确认你的文件地址

首先我们需要确认Jupyter MCP Server项目的地址,用于替换上述参考配置中的"your/path/to/jupyter-mcp-server"

文件资源管理器

Windows 11

在文件资源管理器中找到Jupyter MCP Server对应的文件夹,按下快捷键ctrl+shift+C复制文件路径,参考的路径如下:

C:\Users\username\Desktop\MCP\jupyter-mcp-server

此时,需要注意将路径中的\替换为\\,最终的路径如下:

C:\\Users\\username\\Desktop\\MCP\\jupyter-mcp-server

最后将上述参考JSON格式中的文件路径替换为复制完毕的路径,示例如下:

{
    "mcpServers":{
        "Jupyter-MCP-Server":{
            "command": "uv",
            "args": [
                "run",
                "--directory",
                "C:\\Users\\username\\Desktop\\MCP\\jupyter-mcp-server",
                "src/main.py"
            ],
            "env": {},
            "transport": "stdio"
        }
    }
}

MacOS

在访达中找到Jupyter MCP Server对应的文件夹,按下快捷键option+command+c复制文件路径,参考的路径如下:

/Users/username/Documents/mcp/jupyter-mcp-server

最后将上述参考JSON格式中的文件路径替换为复制完毕的路径,示例如下:

{
    "mcpServers":{
        "Jupyter-MCP-Server":{
            "command": "uv",
            "args": [
                "run",
                "--directory",
                "/Users/username/Documents/mcp/jupyter-mcp-server",
                "src/main.py"
            ],
            "env": {},
            "transport": "stdio"
        }
    }
}

终端

Windows CMD

在对应路径下的终端中输入下述命令:

echo %cd%

此时,参考的输出路径如下:

C:\Users\username\Desktop\MCP\jupyter-mcp-server

此时,需要注意将路径中的\替换为\\,最终的路径如下:

C:\\Users\\username\\Desktop\\MCP\\jupyter-mcp-server

最后将上述参考JSON格式中的文件路径替换为复制完毕的路径,示例如下:

{
    "mcpServers":{
        "Jupyter-MCP-Server":{
            "command": "uv",
            "args": [
                "run",
                "--directory",
                "C:\\Users\\username\\Desktop\\MCP\\jupyter-mcp-server",
                "src/main.py"
            ],
            "env": {},
            "transport": "stdio"
        }
    }
}

MacOS/Linux

在对应路径下的终端中输入下述命令:

pwd

此时,参考的输出路径如下:

/Users/username/Documents/mcp/jupyter-mcp-server

最后将上述参考JSON格式中的文件路径替换为复制完毕的路径,示例如下:

{
    "mcpServers":{
        "Jupyter-MCP-Server":{
            "command": "uv",
            "args": [
                "run",
                "--directory",
                "/Users/username/Documents/mcp/jupyter-mcp-server",
                "src/main.py"
            ],
            "env": {},
            "transport": "stdio"
        }
    }
}

Step2: 在对应客户端里添加MCP服务

接下来在对应客户端里的MCP配置文件中添加MCP服务即可

Cursor

在Cursor右上角打开Cursor Settings(⚙图标),选择Tool & Integrations在MCP Tools中点击New MCP Sever就会跳转到mcp.json文件,呈现的示例结果如下:

{
  "mcpServers": {
    ...(已有的MCP,若没有则为空)
  }
}

在已有的MCP后将之前已经填充完善好的JSON文件黏贴,最终的参考结果如下:

{
  "mcpServers": {
    ...(已有的MCP,若没有则为空),
    "Jupyter-MCP-Server" : {
        ...(上述具体内容)
    }
  }
}

最后保存并关闭mcp.json文件,返回查看MCP Tools中是否出现名为Jupyter-MCP-Server的MCP服务,等待片刻,如果黄灯变绿灯则表明MCP服务启动成功

Trae

在应用边侧打开AI功能管理按钮(⚙图标),选择MCP,点击手动添加中的从JSON导入,输入如下内容:

{
  "mcpServers": {
    "Jupyter-MCP-Server" : {
        ...(上述具体内容)
    }
  }
}

点击确认,打开对应的MCP服务器,查看是否连接成功

Cline

在对话底部打开Manager MCP Servers,点击设置按钮(⚙图标),选择Installed,点击Configure MCP Servers就会跳转到cline_mcp_settings.json文件,呈现的示例结果如下:

{
  "mcpServers": {
    ...(已有的MCP,若没有则为空)
  }
}

在已有的MCP后添加,(英文半角符号)(若无则无需添加),将之前已经填充完善好的JSON文件黏贴之后,最终的参考结果如下:

{
  "mcpServers": {
    ...(已有的MCP,若没有则为空),
    "Jupyter-MCP-Server" : {
        ...(上述具体内容)
    }
  }
}

最后保存并关闭cline_mcp_settings.json文件,返回查看是否出现名为Jupyter-MCP-Server的MCP服务,启动并等待片刻,如果变绿灯则表明MCP服务启动成功

Gemini CLI

可以直接在终端中输入下述命令:

gemini mcp add Jupyter-MCP-Server uv run --directory your/path/to/jupyter-mcp-server src/main.py

或者也可以在项目中.gemini文件夹下的settings.json文件中添加如下内容:

{
    ...(已有的配置,若没有则为空),
    "mcpServers":{
        ...(已有的MCP,若没有则为空),
        "Jupyter-MCP-Server":{
            "command": "uv",
            "args": [
                "run",
                "--directory",
                "your/path/to/jupyter-mcp-server",
                "src/main.py"
            ],
            "env": {}
        }
    }
}

Qwen Coder

可以直接在终端中输入下述命令:

qwen mcp add Jupyter-MCP-Server uv run --directory your/path/to/jupyter-mcp-server src/main.py

或者也可以在项目中.qwen文件夹下的settings.json文件中添加如下内容:

{
    ...(已有的配置,若没有则为空),
    "mcpServers":{
        ...(已有的MCP,若没有则为空),
        "Jupyter-MCP-Server":{
            "command": "uv",
            "args": [
                "run",
                "--directory",
                "your/path/to/jupyter-mcp-server",
                "src/main.py"
            ],
            "env": {}
        }
    }
}

Claude Code

可以直接在终端中输入下述命令:

claude mcp add Jupyter-MCP-Server uv run --directory your/path/to/jupyter-mcp-server src/main.py