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]