Python REPL MCP Server

🚀 Python REPL MCP Server

This MCP server provides a Python REPL (Read-Evaluate-Print Loop) tool. It allows the execution of Python code with persistent sessions via the MCP protocol.

🚀 Quick Start

📦 Installation

No installation required! This project uses uv for dependency management.

🏃‍♂️ Running the Server

Simply run the following command:

uv run src/python_repl/server.py

🤝 Using with Claude Desktop

Add the following configuration to your Claude Desktop configuration file:

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

The server offers three tools:

1. execute_python: Execute Python code with persistent variables.
   • code: The Python code to be executed.
   • reset: An optional boolean value to reset the session.
2. list_variables: Display all variables in the current session.
3. install_package: Install packages from pypi.

💻 Usage Examples

Basic Usage

Set a variable:

a = 42

Use the variable:

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

Advanced Usage

List all variables:

# Use the list_variables tool

Reset the session:

# Use execute_python and set reset to true

🤝 Contribution

Contributions are welcome! 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 the following:

1. Your code follows the existing style.
2. You have updated the required documentation.
3. Consider writing some test code if possible.

For significant changes, please open an issue first to discuss what you want to change.