Python Interpreter Mcp

python-interpreter-mcp：スクリプトを実行する MCP サーバー

概要

構造化された再現可能な環境で任意の Python スクリプトを実行するために設計された、軽量で実験的な MCP サーバーです。uv を利用して、サブプロセス経由でコードスニペットを分離して実行します。

ツール

• run_script
  • 指定されたスクリプトを uv run script.py で実行します。
  • 入力：
    • code(str)：実行するスクリプト
  • 戻り値：スクリプトの標準出力。

設定

OpenAI Agents SDK での使用

async with MCPServerStdio(
            params={
                "command": "uvx",
                "args": ["python-interpreter-mcp"],
            }
    ) as server
...

Claude Desktop での使用

claude_desktop_config.json に次の内容を追加します：

"mcpServers": {
  "interpreter": {
    "command": "uvx",
    "args": ["python-interpreter-mcp"]
  }
}

動作の仕組み

• MCP ツール run_script がスクリプト文字列を受け取ります。
• 作業ディレクトリに隠しフォルダーが作成され、その中にスクリプトが .py ファイルとして保存されます。
• その後、依存関係を分離できる uv run を使ってスクリプトを実行します。
• スクリプトの標準出力を取得し、応答として返します。

使用上の警告

このプロジェクトは、開発の非常に初期段階にあります。

⚠️ 重要な注意事項

• 任意の Python コードを実行するため、悪意のあるコマンドや破壊的なコマンドを含め、あらゆる処理を実行する可能性があります。
• 信頼できるサンドボックス環境でのみ使用してください。
• LLM に組み込む場合は、必ず入力を検証し、ガードレールを設けるか、制限してください。