mcp-python-repl

# 🐍 mcp-python-repl A **production-grade** MCP server providing a persistent Python REPL with multi-session support, sandboxing, and timeout protection. Built for LLM agents that need to execute Python code across multiple turns with **variables that persist between calls**. ## ✨ Features | Feature | Description | |---|---| | **Multi-session** | Isolated sessions with unique IDs — run parallel workflows | | **Persistent namespace** | Variables survive across calls within a session | | **Timeout protection** | Configurable execution timeout (SIGALRM on Unix) | | **Sandboxing** | Optional mode blocks dangerous modules (`subprocess`, `socket`, etc.) | | **Package install** | Install pip packages on-the-fly (prefers `uv` for speed) | | **File execution** | Run `.py` files inside the persistent session | | **Dual transport** | stdio (local) and streamable-http (remote) | | **Full introspection** | List variables, get history, check server status | | **Env-based config** | All settings via `REPL_*` environment variables | ## 🚀 Quick Start ### With Claude Desktop / Cursor (stdio) Add to your MCP config: ```json { "mcpServers": { "python-repl": { "command": "uvx", "args": ["mcp-python-repl"] } } } ``` ### With uv (local dev) ```bash # Clone and run git clone https://github.com/soufiane-aazizi/mcp-python-repl.git cd mcp-python-repl uv run mcp-python-repl ``` ### HTTP transport (remote / multi-client) ```bash REPL_TRANSPORT=streamable-http REPL_PORT=8000 uv run mcp-python-repl ``` ## 🛠️ Tools ### Code Execution | Tool | Description | |---|---| | `repl_run_code` | Execute Python code with persistent namespace | | `repl_run_file` | Execute a `.py` file in the session | | `repl_install_package` | Install a pip package (uses `uv` if available) | ### Namespace Management | Tool | Description | |---|---| | `repl_list_namespace` | List all variables in a session | | `repl_get_variable` | Get the full value of a variable | | `repl_set_vari…