使用说明

1. 安装与运行

1.1 安装依赖

确保你已安装以下软件：

• Python 3.x
• pip（用于管理Python包）
• uvicorn（用于启动WebSocket服务器）

安装这些依赖可以在终端或命令提示符中运行：

pip install uvicorn websockets jupyter-client python-dotenv

1.2 启动Jupyter Notebook

在终端或命令提示符中启动Jupyter Notebook：

jupyter notebook

1.3 启动WebSocket服务器

导航到你的项目目录，然后运行以下命令启动WebSocket服务器：

uvicorn server:app --reload

这将在http://localhost:8000启动一个本地服务器。

2. 使用Claude Desktop

2.1 下载与安装

访问官方链接下载并安装Claude Desktop。

2.2 配置Claude Desktop

打开Claude Desktop，进入设置菜单：

1. 找到API Settings。
2. 填写你的API密钥（如你有）。
3. 点击保存。

2.3 连接Jupyter Notebook

在Claude Desktop中，选择File > Open，然后选择你的Jupyter Notebook文件。

3. 使用外部客户端测试

3.1 启动外部客户端

运行以下命令启动外部客户端：

uv run python src/jupyter_ws_external_client.py

3.2 批处理模式

如果你希望以批处理模式运行，可以使用以下命令：

uv run python src/jupyter_ws_external_client.py --batch

4. 解决问题

4.1 连接问题

如果出现连接超时，请尝试以下步骤：

• 重新启动WebSocket服务器。
• 检查端口冲突：默认端口为8765，若被占用，服务器会自动选择其他可用端口。

4.2 单元格执行问题

确保单元格内容有效且内核正在运行。可以通过以下方式验证：

1. 点击Jupyter Notebook中的Kernel菜单。
2. 确保选择的内核已启动。

4.3 WebSocket端口冲突

如果默认端口8765已被占用，服务器会自动尝试其他可用端口。

5. 限制与注意事项

• 仅支持Jupyter Notebook 6.x版本。
• 文本输出限制为1500字符。
• 不支持高级Jupyter插件交互（如自定义小部件）。
• 连接可能因长时间空闲而超时。

6. 其他资源

受以下项目启发：

• ihrpr
• Datalayer

完整翻译内容请参考上述说明。