Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@python-runnerrun Python code to calculate the first 10 prime numbers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Python MCP Server
An MCP (Model Context Protocol) server that exposes a run_script tool for executing Python code via subprocess.
Installation
uv syncRelated MCP server: MCP Run Python
Usage
Run the server
uv run python server.pyClaude Desktop / Claude Code
claude mcp add --transport stdio --scope user python-runner -- uvx --from git+https://github.com/Drahoxx/python-mcp python-mcpOr for a local installation:
claude mcp add --transport stdio --scope user python-runner -- uv run --directory /path/to/python-mcp python-mcpOpenCode
Add to ~/.config/opencode/opencode.json:
{
"mcpServers": {
"python-runner": {
"command": "uvx",
"args": ["--from", "git+https://github.com/Drahoxx/python-mcp", "python-mcp"]
}
}
}Or for a local installation:
{
"mcpServers": {
"python-runner": {
"command": "uv",
"args": ["run", "--directory", "/path/to/python-mcp", "python-mcp"]
}
}
}Generic MCP Client
Add to your MCP client configuration:
{
"mcpServers": {
"python-runner": {
"command": "uv",
"args": ["run", "--directory", "/path/to/python-mcp", "python", "server.py"]
}
}
}Tool: run_script
Execute Python code and return the result.
Parameters
Name | Type | Default | Description |
|
| required | Python code to execute |
|
|
| Execution timeout in seconds |
Response
Returns a JSON string with:
Field | Type | Description |
|
| Whether execution succeeded (exit code 0) |
|
| Captured standard output |
|
| Captured standard error |
|
| Error message/traceback if failed |
|
| Process exit code (-1 for timeout) |
Examples
Successful execution:
run_script('print("hello")')
# {"success": true, "stdout": "hello\n", "stderr": "", "error": null, "return_code": 0}Syntax error:
run_script('print(')
# {"success": false, "stdout": "", "stderr": "...", "error": "SyntaxError...", "return_code": 1}Runtime error:
run_script('1/0')
# {"success": false, "stdout": "", "stderr": "...", "error": "ZeroDivisionError...", "return_code": 1}Timeout:
run_script('import time; time.sleep(60)', timeout=2)
# {"success": false, "stdout": "", "stderr": "", "error": "Execution timed out after 2 seconds", "return_code": -1}Development
Run tests
uv run pytestRun tests with coverage
uv run pytest --cov=serverThis server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Drahoxx/python-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
