MCP-Code-Executor

Der MCP Code Executor ist ein MCP-Server, der es LLMs ermöglicht, Python-Code in einer bestimmten Python-Umgebung auszuführen. Dadurch können LLMs Code mit Zugriff auf die in der Umgebung definierten Bibliotheken und Abhängigkeiten ausführen.

Merkmale

Ausführen von Python-Code aus LLM-Eingabeaufforderungen
Führen Sie Code in einer angegebenen Umgebung aus (Conda, virtualenv oder UV virtualenv).
Installieren Sie Abhängigkeiten bei Bedarf
Überprüfen Sie, ob Pakete bereits installiert sind
Dynamisches Konfigurieren der Umgebung zur Laufzeit
Konfigurierbares Code-Speicherverzeichnis

Voraussetzungen

Node.js installiert
Eine der folgenden Möglichkeiten:
- Conda installiert und gewünschte Conda-Umgebung erstellt
- Python virtuelle Umgebung
- UV-virtuelle Umgebung

Aufstellen

Klonen Sie dieses Repository:

git clone https://github.com/bazinga012/mcp_code_executor.git

Navigieren Sie zum Projektverzeichnis:

cd mcp_code_executor

Installieren Sie die Node.js-Abhängigkeiten:

npm install

Erstellen Sie das Projekt:

npm run build

Konfiguration

Um den MCP Code Executor-Server zu konfigurieren, fügen Sie Ihrer MCP-Server-Konfigurationsdatei Folgendes hinzu:

Verwenden von Node.js

{
  "mcpServers": {
    "mcp-code-executor": {
      "command": "node",
      "args": [
        "/path/to/mcp_code_executor/build/index.js" 
      ],
      "env": {
        "CODE_STORAGE_DIR": "/path/to/code/storage",
        "ENV_TYPE": "conda",
        "CONDA_ENV_NAME": "your-conda-env"
      }
    }
  }
}

Verwenden von Docker

{
  "mcpServers": {
    "mcp-code-executor": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp-code-executor"
      ]
    }
  }
}

Hinweis: Das Dockerfile wurde nur mit dem Umgebungstyp venv-uv getestet. Für andere Umgebungstypen sind möglicherweise zusätzliche Konfigurationen erforderlich.

Umgebungsvariablen

Erforderliche Variablen

CODE_STORAGE_DIR : Verzeichnis, in dem der generierte Code gespeichert wird

Umgebungstyp (wählen Sie eine Konfiguration aus)

Für Conda:
- ENV_TYPE : Auf conda setzen
- CONDA_ENV_NAME : Name der zu verwendenden Conda-Umgebung
Für Standard-Virtualenv:
- ENV_TYPE : Auf venv setzen
- VENV_PATH : Pfad zum Virtualenv-Verzeichnis
Für UV Virtualenv:
- ENV_TYPE : Auf venv-uv einstellen
- UV_VENV_PATH : Pfad zum UV-Virtualenv-Verzeichnis

Verfügbare Tools

Der MCP Code Executor stellt LLMs die folgenden Tools zur Verfügung:

1. `execute_code`

Führt Python-Code in der konfigurierten Umgebung aus.

{
  "name": "execute_code",
  "arguments": {
    "code": "import numpy as np\nprint(np.random.rand(3,3))",
    "filename": "matrix_gen"
  }
}

2. `install_dependencies`

Installiert Python-Pakete in der Umgebung.

{
  "name": "install_dependencies",
  "arguments": {
    "packages": ["numpy", "pandas", "matplotlib"]
  }
}

3. `check_installed_packages`

Überprüft, ob in der Umgebung bereits Pakete installiert sind.

{
  "name": "check_installed_packages",
  "arguments": {
    "packages": ["numpy", "pandas", "non_existent_package"]
  }
}

4. `configure_environment`

Ändert die Umgebungskonfiguration dynamisch.

{
  "name": "configure_environment",
  "arguments": {
    "type": "conda",
    "conda_name": "new_env_name"
  }
}

5. `get_environment_config`

Ruft die aktuelle Umgebungskonfiguration ab.

{
  "name": "get_environment_config",
  "arguments": {}
}

Verwendung

Nach der Konfiguration ermöglicht der MCP Code Executor LLMs die Ausführung von Python-Code, indem er eine Datei im angegebenen CODE_STORAGE_DIR generiert und sie innerhalb der konfigurierten Umgebung ausführt.

LLMs können Code generieren und ausführen, indem sie in ihren Eingabeaufforderungen auf diesen MCP-Server verweisen.

Abwärtskompatibilität

Dieses Paket ist abwärtskompatibel mit früheren Versionen. Benutzer früherer Versionen, die nur eine Conda-Umgebung angegeben haben, können ohne Änderungen an ihrer Konfiguration weiterarbeiten.

Beitragen

Beiträge sind willkommen! Bitte melden Sie ein Problem oder senden Sie einen Pull Request.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

MCP Code Executor

Integrations