iflow-mcp_hileamlakb-prims

<p align="left"> <img src="primslogo.png" alt="PRIMS Logo" width="200"/> <a href="#"><img src="https://img.shields.io/badge/status-alpha-orange?style=for-the-badge" alt="Status: Alpha"/></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=for-the-badge" alt="License: MIT"/></a> </p> # PRIMS – Python Runtime Interpreter MCP Server PRIMS is a tiny open-source **Model Context Protocol (MCP)** server that lets LLM agents run arbitrary Python code in a secure, throw-away sandbox. • **One tool, one job.** Exposes a single MCP tool – `run_code` – that executes user-supplied Python and streams back `stdout / stderr`. • **Isolated & reproducible.** Each call spins up a fresh virtual-env, installs any requested pip packages, mounts optional read-only files, then nukes the workspace. • **Zero config.** Works over MCP/stdio or drop it in Docker. --- ## Quick-start ### 1. Local development environment ```bash chmod +x scripts/setup_env.sh # once, to make the script executable ./scripts/setup_env.sh # creates .venv & installs deps # activate the venv in each new shell source .venv/bin/activate ``` ### 2. Launch the server ```bash python -m server.main # binds http://0.0.0.0:9000/mcp ``` ### 3. Docker ```bash # Quick one-liner (build + run) chmod +x scripts/docker_run.sh ./scripts/docker_run.sh # prints the MCP URL when ready ``` ## Examples ### List available tools You can use the provided script to list all tools exposed by the server: ```bash python examples/list_tools.py ``` Expected output (tool names and descriptions may vary): ``` Available tools: - run_code: Execute Python code in a secure sandbox with optional dependencies & file mounts. - list_dir: List files/directories in your session workspace. - preview_file: Preview up to 8 KB of a text file from your session workspace. - persist_artifact: Upload an output/ file to a presigned URL for permanent storage. - mount_file: Downl…