Safe Local Python Executor

An MCP server (stdio transport) that wraps Hugging Face's LocalPythonExecutor (from the smolagents framework). It is a custom Python runtime that provides basic isolation/security when running Python code generated by LLMs. This package allows to expose the Python executor via MCP (Model Context Protocol) as a tool for LLM apps like Claude Desktop, Cursor or any other MCP compatible client. In case of Claude Desktop this tool is an easy way to add alternative to ChatGPT's Python Interpreter plugin.

Features

• Exposes run_python tool
• Safer execution of Python code compared to direct use of Python
• Ran via uv in Python venv
• Restricted list of imports
  • collections
  • datetime
  • itertools
  • math
  • queue
  • random
  • re
  • stat
  • statistics
  • time
  • unicodedata

LocalPythonExecutor provides a good balance between direct use of local Python environment() which is easier to set-up but dangerous) AND remote execution in Dokcer container or a VM/3rd party service. Read more here.

Installation and Execution

1. Install uv (e.h. brew install uv on macOS or use official docs)
2. Clone the repo, change the directory cd mcp_safe_local_python_executor
3. The server can be started via command line uv run mcp_server.py, venv will be created automatically, depedencies (smollagents, mcp) will be installed

Configuring Claude Desktop

1. Make sure you have Claude for Desktop installed (download from claude.ai)

2. Edit your Claude for Desktop configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Or open Claude Desktop -> Settings -> Developer -> click "Edit Config" button

3. Add the following configuration:

{
    "mcpServers": {
        "safe-local-python-executor": {
            "command": "uv",
            "args": [
                "--directory", 
                "/path/to/mcp_local_python_executor/",
                "run",
                "mcp_server.py"
            ]
        }
    }
}

4. Restart Claude for Desktop
5. The Python executor tool will now be available in Claude (you'll see hammer icon in the message input field)

Example Prompts

Once configured, you can use prompts like:

• "Calculate the factorial of 5 using Python"
• "Create a list of prime numbers up to 100"
• "Solve this equation (use Python): x^2 + 5x + 6 = 0"

Development

Clone the repo. Use uv to create venv, install dev dependencies, run tests:

uv venv .venv
uv sync --group dev
python -m pytest tests/