MCP Python Executor

MCP Python Executor

Python コードを実行し、Python パッケージを管理する Model Context Protocol（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[];
}

例：