MCP Python Interpreter

Ein Model Context Protocol (MCP)-Server, der es LLMs ermöglicht, mit Python-Umgebungen zu interagieren, Dateien zu lesen und zu schreiben, Python-Code auszuführen und Entwicklungs-Workflows zu verwalten.

Merkmale

• Umgebungsverwaltung : Auflisten und Verwenden verschiedener Python-Umgebungen (System und Conda)

• Codeausführung : Führen Sie Python-Code oder -Skripte in jeder verfügbaren Umgebung aus

• Paketverwaltung : Installierte Pakete auflisten und neue installieren

• Dateioperationen :

  • Lesen von Dateien aller Art (Text, Quellcode, Binärdateien)

  • Schreiben Sie Text- und Binärdateien

• Python-Eingabeaufforderungen : Vorlagen für allgemeine Python-Aufgaben wie Funktionserstellung und Debuggen

Related MCP server: MCP Python Toolbox

Installation

Sie können den MCP Python Interpreter mit pip installieren:

pip install mcp-python-interpreter

Oder mit UV:

uv install mcp-python-interpreter

Verwendung mit Claude Desktop

1. Installieren Sie Claude Desktop

2. Öffnen Sie Claude Desktop, klicken Sie auf Menü und dann auf Einstellungen

3. Gehen Sie zur Registerkarte „Entwickler“ und klicken Sie auf „Konfiguration bearbeiten“.

4. Fügen Sie Ihrer claude_desktop_config.json Folgendes hinzu:

{
  "mcpServers": {
    "mcp-python-interpreter": {
        "command": "uvx",
        "args": [
            "mcp-python-interpreter",
            "--dir",
            "/path/to/your/work/dir",
            "--python-path",
            "/path/to/your/python"
        ],
        "env": {
            "MCP_ALLOW_SYSTEM_ACCESS": 0
        },
    }
  }
}

Für Windows:

{
  "mcpServers": {
    "python-interpreter": {
      "command": "uvx",
      "args": [
        "mcp-python-interpreter",
        "--dir",
        "C:\\path\\to\\your\\working\\directory",
        "--python-path",
        "/path/to/your/python"
      ],
        "env": {
            "MCP_ALLOW_SYSTEM_ACCESS": 0
        },
    }
  }
}

5. Starten Sie Claude Desktop neu

6. Sie sollten jetzt das MCP-Tools-Symbol in der Chat-Oberfläche sehen

Der Parameter --dir ist erforderlich und gibt an, wo alle Dateien gespeichert und ausgeführt werden. Dies trägt zur Aufrechterhaltung der Sicherheit bei, indem der MCP-Server auf ein bestimmtes Verzeichnis beschränkt wird.

Voraussetzungen

• Stellen Sie sicher, dass uv installiert ist. Falls nicht, installieren Sie es mit:

  curl -LsSf https://astral.sh/uv/install.sh | sh

• Für Windows:

  powershell -ExecutionPolicy Bypass -Command "iwr -useb https://astral.sh/uv/install.ps1 | iex"

Verfügbare Tools

Der Python-Interpreter bietet die folgenden Tools:

Umgebungs- und Paketverwaltung

• list_python_environments : Listet alle verfügbaren Python-Umgebungen auf (System und Conda)

• list_installed_packages : Listet die in einer bestimmten Umgebung installierten Pakete auf

• install_package : Installieren Sie ein Python-Paket in einer bestimmten Umgebung

Codeausführung

• run_python_code : Python-Code in einer bestimmten Umgebung ausführen

• run_python_file : Führen Sie eine Python-Datei in einer bestimmten Umgebung aus

Dateioperationen

• read_file : Liest Inhalte beliebiger Dateitypen, mit Größen- und Sicherheitsbeschränkungen

  • Unterstützt Textdateien mit Syntaxhervorhebung

  • Zeigt die Hex-Darstellung für Binärdateien an

• write_file : Erstellen oder überschreiben Sie Dateien mit Text- oder Binärinhalt

• write_python_file : Erstellen oder überschreiben Sie eine Python-Datei speziell

• list_directory : Listet Python-Dateien in einem Verzeichnis auf

Verfügbare Ressourcen

• python://environments : Listet alle verfügbaren Python-Umgebungen auf

• python://packages/{env_name} : Listet installierte Pakete für eine bestimmte Umgebung auf

• python://file/{file_path} : Ruft den Inhalt einer Python-Datei ab

• python://directory/{directory_path} : Listet alle Python-Dateien in einem Verzeichnis auf

Eingabeaufforderungen

• python_function_template : Erstellen Sie eine Vorlage für eine Python-Funktion

• refactor_python_code : Helfen Sie beim Refactoring von Python-Code

• debug_python_error : Helfen Sie beim Debuggen eines Python-Fehlers

Beispielverwendung

Hier sind einige Beispiele dafür, was Sie Claude mit diesem MCP-Server tun lassen können:

• „Zeigen Sie mir alle verfügbaren Python-Umgebungen auf meinem System“

• „Führen Sie diesen Python-Code in meiner Conda-Base-Umgebung aus: print(‚Hallo Welt!‘)“

• „Erstellen Sie eine neue Python-Datei namens ‚hello.py‘ mit einer Funktion, die Hallo sagt.“

• „Lesen Sie den Inhalt meiner Datei ‚data.json‘“

• „Schreiben Sie eine neue Konfigurationsdatei mit diesen Einstellungen …“

• „Listet alle in meiner System-Python-Umgebung installierten Pakete auf“

• „Installieren Sie das Anforderungspaket in meiner System-Python-Umgebung.“

• „Führen Sie data_analysis.py mit diesen Argumenten aus: --input=data.csv --output=results.csv“

Dateiverwaltungsfunktionen

Der MCP Python Interpreter unterstützt jetzt umfassende Dateioperationen:

• Lesen Sie Text- und Binärdateien bis zu 1 MB

• Schreiben Sie Text- und Binärdateien

• Syntaxhervorhebung für Quellcodedateien

• Hex-Darstellung für Binärdateien

• Strikte Dateipfadsicherheit (nur innerhalb des Arbeitsverzeichnisses)

Sicherheitsüberlegungen

Dieser MCP-Server hat Zugriff auf Ihre Python-Umgebungen und Ihr Dateisystem. Zu den wichtigsten Sicherheitsfunktionen gehören:

• Isoliertes Arbeitsverzeichnis

• Dateigrößenbeschränkungen

• Schreibvorgänge außerhalb des Arbeitsverzeichnisses verhindert

• Expliziter Überschreibschutz

Seien Sie immer vorsichtig, wenn Sie Code oder Dateivorgänge ausführen, die Sie nicht vollständig verstehen.

Lizenz

MIT