mcp-python-executor

# MCP Python Executor A Model Context Protocol (MCP) server for executing Python code and managing Python packages. ## Features - Execute Python code with safety constraints - Install and manage Python packages - Pre-configure commonly used packages - Resource monitoring and limits - Health checks and metrics - Structured logging ## Configuration The server can be configured through environment variables in the MCP settings: ```json { "mcpServers": { "mcp-python-executor": { "command": "node", "args": ["path/to/python-executor/build/index.js"], "env": { "PREINSTALLED_PACKAGES": "numpy pandas matplotlib scikit-learn", "MAX_MEMORY_MB": "512", "EXECUTION_TIMEOUT_MS": "30000", "MAX_CONCURRENT_EXECUTIONS": "5", "LOG_LEVEL": "info", "LOG_FORMAT": "json" } } } } ``` ### Environment Variables - `PREINSTALLED_PACKAGES`: Space-separated list of Python packages to install on startup - `MAX_MEMORY_MB`: Maximum memory limit per execution (default: 512) - `EXECUTION_TIMEOUT_MS`: Maximum execution time in milliseconds (default: 30000) - `MAX_CONCURRENT_EXECUTIONS`: Maximum number of concurrent executions (default: 5) - `LOG_LEVEL`: Logging level (debug|info|error, default: info) - `LOG_FORMAT`: Log format (json|text, default: json) ## Available Tools ### 1. execute_python Execute Python code and return the results. ```typescript interface ExecutePythonArgs { code?: string; // Python code to execute (inline) scriptPath?: string; // Path to existing Python script file (alternative to code) inputData?: string[]; // Optional input data } ``` Examples: ```javascript // Example with inline code { "code": "print('Hello, World!!')\nfor i in range(3): print(i)", "inputData": ["optional", "input", "data"] } // Example with script path { "scriptPath": "/path/to/your_script.py", "inputData": ["optional", "input", "data"] } ``` ### 2. install_packages Install Python packages. ```typescript interface InstallPackagesArgs { packages: string[]; } ``` Example: ```