Ralph Wiggum Loop

io.github.sheldonrobinson由 GitHub 账号 sheldonrobinson 发布v1.1.0更新于 Oct 27, 2026

Autonomous iterative AI development MCP server with spec-driven worker/reviewer SHIP/REVISE loops.

已验证STDIO仅桌面开发者工具AI 与机器学习

概览

AI 生成的概览

本地 MCP 服务器，运行自主迭代式开发循环：worker 模型实现规格，reviewer 模型给出 SHIP 或 REVISE 决定。

可以做什么
  • 运行两阶段迭代开发循环，由 worker 模型执行工作、reviewer 模型进行跨模型评审，直到评审给出 SHIP。
  • 通过命令行以任务提示和 profile 驱动循环，或以 stdio、streamable HTTP 方式提供给助手调用。
  • 从配置的配方目录加载工作流配方，并在配置的状态目录中保存循环状态与迭代历史。
  • 可作为 agent 插件安装，附带规格驱动开发技能与 Stop 钩子。
适用场景
适合希望助手自主完成多步骤编码任务、并由第二个模型在每轮迭代后评审再决定是否通过的情况。更适用于本地机器上的规格驱动开发工作，而非一次性问答。
运行要求
作为本地进程在用户机器上运行，仅支持桌面端。Linux/macOS 需要 POSIX shell，Windows 需要 PowerShell；HTTP 模式会在本地端口（如 127.0.0.1:8080）监听。需通过环境变量 RALPH_RECIPE_DIR 和 RALPH_STATE_BASE 指定两个目录。未声明任何身份验证。
安装前请注意
循环会自主修改项目代码，并在 RALPH_STATE_BASE 指定的状态目录中保留迭代历史，建议指向可审查或可回滚的仓库。worker 与 reviewer 依赖外部模型，任务内容会发送给这些服务提供方。HTTP 模式未声明身份验证，应仅绑定本机地址。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Ralph Wiggum Loop，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

ralph-wiggum-loop

Multi-model iterative development agent plugin — Ralph Loop with cross-model worker/reviewer architecture, spec-driven development skills, Stop hooks, and SHIP/REVISE decision engine.

[License: MIT] [Agent Plugin] [GitHub Pages]

Overview

The Ralph Loop implements a two-phase iterative workflow where a worker model does the work and a reviewer model provides cross-model review, iterating until the reviewer says "SHIP".

This project is a cross-platform Agent Plugin (plugin.json, mcp.json, .agents/skills/ralph-wiggum-loop/ & skills/ralph-wiggum-loop/) with native implementations for:

  • Linux / macOS (Bash): bin/ralph-wiggum-loop.sh (using bin/mcp-sdk.sh)
  • Windows (PowerShell): bin/ralph-wiggum-loop.ps1 (using bin/mcp-sdk.psm1)
  • Polyglot Runner: bin/script-runner.sh / bin/script-runner.ps1 (runs in both POSIX sh/bash and PowerShell)

Install Skill (.agents/skills/)

Per the Agent Skills Specification, install the skill to .agents/skills/:

bash
# Project-level (.agents/skills/ralph-wiggum-loop) or User-level (~/.agents/skills/ralph-wiggum-loop)mkdir -p .agents/skillscp -R skills/ralph-wiggum-loop .agents/skills/ralph-wiggum-loop
powershell
New-Item -ItemType Directory -Path .agents/skills -Force | Out-NullCopy-Item -Recurse -Force skills/ralph-wiggum-loop .agents/skills/ralph-wiggum-loop

[Ralph Wiggum Loop MCP server]

OS-Specific MCP Servers (mcp.json)

MCP Server NameOS / RuntimeTransportCommand / Endpoint
ralph-wiggum-loopLinux / macOS (Bash)stdio./bin/script-runner.sh ralph-wiggum-loop --stdio
ralph-wiggum-loop-pwshWindows (PowerShell 7+)stdiopwsh -NoProfile -ExecutionPolicy Bypass -File ${PLUGIN_ROOT}/bin/script-runner.ps1 ralph-wiggum-loop --stdio
ralph-wiggum-loop-powershellWindows (PowerShell 5.1)stdiopowershell.exe -NoProfile -ExecutionPolicy Bypass -File ${PLUGIN_ROOT}/bin/script-runner.ps1 ralph-wiggum-loop --stdio
ralph-wiggum-loop-httpCross-Platformstreamable-httphttp://127.0.0.1:8080/mcp

Quick Start

1. CLI Mode

  • Linux / macOS (Bash):
    bash
    ./bin/ralph-wiggum-loop.sh "Implement user authentication with JWT tokens" --profile pro
  • Windows (PowerShell):
    powershell
    pwsh -NoProfile -ExecutionPolicy Bypass -File .\bin\ralph-wiggum-loop.ps1 "Implement user authentication with JWT tokens" --profile pro

2. MCP Server (stdio Mode)

  • Linux / macOS (Bash):
    bash
    ./bin/ralph-wiggum-loop.sh --stdio
  • Windows (PowerShell):
    powershell
    pwsh -NoProfile -ExecutionPolicy Bypass -File .\bin\ralph-wiggum-loop.ps1 --stdio

3. MCP Server (streamable-http Service Mode)

  • Linux / macOS (Bash):
    bash
    ./bin/script-runner.sh start-http-server start --host 127.0.0.1 --port 8080
  • Windows (PowerShell):
    powershell
    pwsh -NoProfile -ExecutionPolicy Bypass -File .\bin\script-runner.ps1 start-http-server start --host 127.0.0.1 --port 8080

Documentation

Repository

License

MIT

来源：README.md，提交 f094b28

工具

0
SourceWeft 曾在隔离沙箱中以无凭据方式启动该软件包一次，以列出其工具，但未能完成：该软件包类型无法在沙箱中运行。

版本历史

1
  1. v1.1.0最新Oct 23, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分