home / mcp / ralph wiggum mcp server

Ralph Wiggum MCP Server

Provides iterative AI development loops with history tracking, git integration, and analytics.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "cbuntingde-ralph-wiggum-mcp": {
      "command": "npx",
      "args": [
        "ralph-wiggum-mcp"
      ],
      "env": {
        "RALPH_AUTO_COMMIT": "false",
        "RALPH_HISTORY_LIMIT": "100",
        "RALPH_MAX_ITERATIONS": "50",
        "RALPH_STAGNATION_THRESHOLD": "5"
      }
    }
  }
}

Available tools

ralph_loop

Start an iterative development loop with configurable prompts, templates, and iteration controls.

ralph_iterate

Process the next iteration, feeding in last output, modified files, commands, errors, and tool presets.

ralph_cancel

Cancel the active Ralph loop to stop further iterations.

ralph_status

Get current iteration status with progress details including stagnation signals.

ralph_history

Retrieve a detailed history of all iterations and associated results.

ralph_git_status

Get the current Git status and a summary of changes.

ralph_git_commit

Create a Git commit manually with a provided message.

ralph_git_context

Fetch context from recent Ralph commits to inform future iterations.

ralph_run_tools

Run external tool presets such as test suites and linters.

ralph_detect_tools

Detect available tool presets for your project.

ralph_list_tools

List all tool presets with descriptions.

ralph_list_templates

List available loop templates.

ralph_get_template

Get details for a specific template, including prompt and settings.