MCP Python Interpreter

Features

• Environment Management: List and use different Python environments (system and conda)

• Code Execution: Run Python code or scripts in any available environment

• Package Management: List installed packages and install new ones

• File Operations:

• Python Prompts: Templates for common Python tasks like function creation and debugging

Installation

Usage with Claude Desktop

1. Install Claude Desktop

2. Open Claude Desktop, click on menu, then Settings

3. Go to Developer tab and click "Edit Config"

4. Add the following to your claude_desktop_config.json:

1. Restart Claude Desktop

2. You should now see the MCP tools icon in the chat interface

Prerequisites

• Make sure you have uv installed. If not, install it using:

• For Windows:

Available Tools

Environment and Package Management

• list_python_environments: List all available Python environments (system and conda)

• list_installed_packages: List packages installed in a specific environment

• install_package: Install a Python package in a specific environment

Code Execution

• run_python_code: Execute Python code in a specific environment

• run_python_file: Execute a Python file in a specific environment

File Operations

• read_file: Read contents of any file type, with size and safety limits

• write_file: Create or overwrite files with text or binary content

• write_python_file: Create or overwrite a Python file specifically

• list_directory: List Python files in a directory

Available Resources

• python://environments: List all available Python environments

• python://packages/{env_name}: List installed packages for a specific environment

• python://file/{file_path}: Get the content of a Python file

• python://directory/{directory_path}: List all Python files in a directory

Prompts

• python_function_template: Generate a template for a Python function

• refactor_python_code: Help refactor Python code

• debug_python_error: Help debug a Python error

Example Usage

• "Show me all available Python environments on my system"

• "Run this Python code in my conda-base environment: print('Hello, world!')"

• "Create a new Python file called 'hello.py' with a function that says hello"

• "Read the contents of my 'data.json' file"

• "Write a new configuration file with these settings..."

• "List all packages installed in my system Python environment"

• "Install the requests package in my system Python environment"

• "Run data_analysis.py with these arguments: --input=data.csv --output=results.csv"

File Handling Capabilities

• Read text and binary files up to 1MB

• Write text and binary files

• Syntax highlighting for source code files

• Hex representation for binary files

• Strict file path security (only within the working directory)

Security Considerations

• Isolated working directory

• File size limits

• Prevented writes outside the working directory

• Explicit overwrite protection

License

MCP Python Interpreter

Features

• Environment Management: List and use different Python environments (system and conda)

• Code Execution: Run Python code or scripts in any available environment

• Package Management: List installed packages and install new ones

• File Operations:

• Python Prompts: Templates for common Python tasks like function creation and debugging

Installation

Usage with Claude Desktop

1. Install Claude Desktop

2. Open Claude Desktop, click on menu, then Settings

3. Go to Developer tab and click "Edit Config"

4. Add the following to your claude_desktop_config.json:

1. Restart Claude Desktop

2. You should now see the MCP tools icon in the chat interface

Prerequisites

• Make sure you have uv installed. If not, install it using:

• For Windows:

Available Tools

Environment and Package Management

• list_python_environments: List all available Python environments (system and conda)

• list_installed_packages: List packages installed in a specific environment

• install_package: Install a Python package in a specific environment

Code Execution

• run_python_code: Execute Python code in a specific environment

• run_python_file: Execute a Python file in a specific environment

File Operations

• read_file: Read contents of any file type, with size and safety limits

• write_file: Create or overwrite files with text or binary content

• write_python_file: Create or overwrite a Python file specifically

• list_directory: List Python files in a directory

Available Resources

• python://environments: List all available Python environments

• python://packages/{env_name}: List installed packages for a specific environment

• python://file/{file_path}: Get the content of a Python file

• python://directory/{directory_path}: List all Python files in a directory

Prompts

• python_function_template: Generate a template for a Python function

• refactor_python_code: Help refactor Python code

• debug_python_error: Help debug a Python error

Example Usage

• "Show me all available Python environments on my system"

• "Run this Python code in my conda-base environment: print('Hello, world!')"

• "Create a new Python file called 'hello.py' with a function that says hello"

• "Read the contents of my 'data.json' file"

• "Write a new configuration file with these settings..."

• "List all packages installed in my system Python environment"

• "Install the requests package in my system Python environment"

• "Run data_analysis.py with these arguments: --input=data.csv --output=results.csv"

File Handling Capabilities

• Read text and binary files up to 1MB

• Write text and binary files

• Syntax highlighting for source code files

• Hex representation for binary files

• Strict file path security (only within the working directory)

Security Considerations

• Isolated working directory

• File size limits

• Prevented writes outside the working directory

• Explicit overwrite protection

License