Python REPL

Provides a Python REPL server for executing code and shell commands, enabling complex data analysis and system administration tasks.

Installation Instructions

README: https://github.com/lyuhau/claude-mcp-repl

Claude REPL Server

A Python-based REPL server that enhances Claude with Python execution, shell commands, and file manipulation capabilities.

Features

Python Tools

• One-off Python (python): Run code in fresh environments

  • Great for quick calculations and tests
  • Pandas and PyArrow support available
  • Clean environment each time

• Session-based Python (python_session): Run code with persistent state

  • Keep variables between executions
  • Perfect for data analysis workflows
  • Sessions remain active for 5 minutes

Shell Tools

• Command execution (shell): Run shell commands

  • Quick commands return immediately
  • Long-running commands switch to async mode
  • Returns task ID for tracking

• Task status (shell_status): Monitor long-running commands

  • Check progress of async commands
  • Get outputs when completed
  • View execution time and results

File Tools

• File modification (perl): Safe text processing
  • Pattern-based search and replace
  • Multi-line transformations
  • UTF-8 support built-in
  • Preserves file structure

Installation

1. Clone the repository
2. Install dependencies:

   poetry install
   

   or

   uv pip install -r pyproject.toml
   

Configuration

Add to your Claude Desktop config file:

{
  "mcpServers": {
    "repl": {
      "command": "/path/to/python/env/bin/python",
      "args": ["-m", "repl"]
    }
  }
}

Config locations:

• Windows: %APPDATA%/Roaming/Claude/claude_desktop_config.json
• macOS: (TBD)
• Linux: (TBD)

For detailed setup instructions and alternative configurations, see INSTALLATION.md.

Contributing

Contributions welcome! Please see CONTRIBUTING.md for guidelines.

License

[Add license info]