REPL

GitHub
Integrates with
Python, Shell, Perl

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]