bimalpaudels/python-interpreter-mcp
3.2
If you are the rightful owner of python-interpreter-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A MCP server to run scripts
python-interpreter-mcp: A MCP server to run scripts
Overview
A lightweight, experimental MCP server designed to execute arbitrary Python scripts in a structured and reproducible environment. It leverages uv to run isolated code snippets through subprocesses.
Tools
run_script- Runs the given script with
uv run script.py. - Input:
code(str): Script to be run
- Return: The stdout of the given script.
- Runs the given script with
Configuration
Usage with OpenAI Agents SDK
async with MCPServerStdio(
params={
"command": "uvx",
"args": ["python-interpreter-mcp"],
}
) as server
...
Usage with Claude Desktop
Add this to your claude_desktop_config.json:
"mcpServers": {
"interpreter": {
"command": "uvx",
"args": ["python-interpreter-mcp"]
}
}
How it works
- A script string is received by the MCP tool
run_script. - A hidden folder is created in cwd, and the script is saved as a
.pyfile inside it. - The script is then executed using
uv run, which ensures dependency isolation. - The stdout of the script is captured and returned as the response.
Usage Warnings
This project is in a very early stage of development.
⚠️ Important notes
- It executes arbitrary Python code, which means it can run anything — including malicious or destructive commands.
- Use only in trusted, sandboxed environments.
- You should always validate, guardrail, or restrict inputs when wiring this into an LLM.
