Python Interpreter MCP

🚀 Python インタープリター MCP：任意のPythonスクリプトを実行するためのMCPサーバー

この軽量で実験的なMCPサーバーは、構造化された再現可能な環境で任意のPythonスクリプトを実行することを目的としています。uv を利用して、サブプロセスでコードを隔離して実行します。

✨ 主な機能

ツール

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

📦 インストール

このREADMEには具体的なインストール手順が記載されていないため、このセクションを省略します。

💻 使用例

基本的な使用法

# ここには具体的な基本使用例のコードが元READMEになかったため、省略

高度な使用法

OpenAI 代理 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と統合する際には、常に入力を検証し、ガードレールや制限を設定してください。