MCP Python Executor

MCP Python Executor

用于执行 Python 代码和管理 Python 包的模型上下文协议（MCP）服务。

功能

• 在安全约束下执行 Python 代码
• 安装和管理 Python 包
• 预先配置常用包
• 资源监控和限制
• 健康检查和指标
• 结构化日志

配置

可在 MCP 设置中通过环境变量配置服务：

{
  "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"
      }
    }
  }
}

环境变量

• PREINSTALLED_PACKAGES：以空格分隔的 Python 包列表，服务启动时安装
• MAX_MEMORY_MB：每次执行的最大内存限制（默认值：512）
• EXECUTION_TIMEOUT_MS：最大执行时间，单位为毫秒（默认值：30000）
• MAX_CONCURRENT_EXECUTIONS：最大并发执行数（默认值：5）
• LOG_LEVEL：日志级别（debug|info|error，默认值：info）
• LOG_FORMAT：日志格式（json|text，默认值：json）

可用工具

1. execute_python

执行 Python 代码并返回结果。

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
}

示例：

// 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

安装 Python 包。

interface InstallPackagesArgs {
  packages: string[];
}

示例：