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]