Python REPL MCP Server

This MCP server provides a Python REPL (Read-Eval-Print Loop) as a tool. It allows execution of Python code through the MCP protocol with a persistent session.

Setup

No setup needed! The project uses uv for dependency management.

Running the Server

Simply run:

uv run src/python_repl/server.py

Usage with Claude Desktop

Add this configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "python-repl": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/python-repl-server",
        "run",
        "mcp_python"
      ]
    }
  }
}

The server provides three tools:

execute_python: Execute Python code with persistent variables
- code: The Python code to execute
- reset: Optional boolean to reset the session
list_variables: Show all variables in the current session
install_package: Install a package from pypi

Examples

Set a variable:

a = 42

Use the variable:

print(f"The value is {a}")

List all variables:

# Use the list_variables tool

Reset the session:

# Use execute_python with reset=true

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. Here are some ways you can contribute:

Report bugs
Suggest new features
Improve documentation
Add test cases
Submit code improvements

Before submitting a PR, please ensure:

Your code follows the existing style
You've updated documentation as needed
Maybe write some tests?

For major changes, please open an issue first to discuss what you would like to change.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

A server that provides a persistent Python REPL environment through the MCP protocol, allowing execution of Python code, variable management, and package installation.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Lodestar MCP Server
kanlanc
-
security
F
license
-
quality
This is an MCP server that facilitates building tools for interacting with various APIs and workflows, supporting Python-based development with potential for customizable prompts and user configurations.
Last updated -
Python
MCP Builder
XD3an
-
security
F
license
-
quality
A Python-based server that helps users easily install and configure other MCP servers across different platforms.
Last updated -
2
Python
Python MCP Server Template
nictuku
-
security
A
license
-
quality
A template repository for creating custom Model Context Protocol (MCP) servers in Python that can be integrated with applications like Claude Desktop or Cursor.
Last updated -
5
Python
MIT License
MCP-123
Tylersuard
-
security
F
license
-
quality
A minimal Python package for easily setting up and running MCP servers and clients, allowing functions to be automatically exposed as tools that LLMs can use with just 2 lines of code.
Last updated -
23
Python

View all related MCP servers

Python REPL MCP Server