Jupythunder

Name: Jupythunder
Author: kbsooo

@kbsooo

代码仓库

关于 Jupythunder

暂无概览

#mathgpt #math-solver #math-assistant

基本信息

分类

其他

传输方式

stdio

发布者

kbsooo

提交者

Byungsoo Kang

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "jupythunder": {
      "command": "/absolute/path/python",
      "args": [
        "/absolute/path/jupythunder_server.py"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Jupythunder?

Jupythunder is a middleware that connects the LLM chat interface (Claude) with Jupyter Notebook. It allows users to interact with Jupyter Notebook using natural language, converting natural language requests into Python code and executing it remotely.

How to use Jupythunder?

Install prerequisites (Python 3.10+, Jupyter Notebook, Claude for Desktop), clone the repository, and install dependencies. Run the Jupyter notebook server and the MCP server, then configure Claude for Desktop with absolute paths to Python and jupythunder_server.py. Use commands like /notebook:name to create notebooks, /open:name to open existing ones, and natural language instructions for data analysis, code execution, and querying.

Key features of Jupythunder

Natural language code conversion by LLM
Remote Jupyter Notebook connection via URL/token
Code execution and result retrieval
Function/variable queries via /question command
Session state and connection management
Notebook file creation, opening, and saving
Natural language data analysis and visualization
Cell content viewing, selective execution, and sequential execution

Use cases of Jupythunder

Perform data analysis by describing steps in natural language
Automate Python coding without manual notebook interaction
Query and debug notebook functions and variables conversationally
Create and manage .ipynb files remotely through chat
Execute cells selectively or sequentially for iterative workflows

FAQ from Jupythunder

What is Jupythunder and how does it differ from other Jupyter tools?

Jupythunder is a middleware that links Claude (an LLM chat interface) directly to a Jupyter Notebook server, enabling natural language commands for coding and analysis instead of manual notebook editing.

What are the runtime dependencies for Jupythunder?

Python 3.10+, Jupyter Notebook, Claude for Desktop (or another MCP client), and Python packages: mcp[cli]>=1.5.0, requests>=2.31.0, websocket-client>=1.6.0, python-dotenv>=1.0.0, urllib3>=2.0.0.

Where does data live when using Jupythunder?

Data and notebooks reside on the remote Jupyter Notebook server; Jupythunder connects to that server via a provided URL and token, executes code, and saves results there.

What are known limitations or common errors?

The most common error is spawn pythonENOENT when the Python executable path is not found; use absolute paths or python3. Jupyter connection fails if the server is not running or the URL/token is incorrect. Notebook creation may fail due to permissions or invalid names.

What transport and authentication does Jupythunder use?

Jupythunder uses the MCP (Model Context Protocol) for communication with Claude and connects to Jupyter via HTTP/WebSocket using a user-provided URL and token for authentication.