Skip to main content

CloneLoop - Clone your work patterns from conversations, let AI execute by your standards continuously.

Project description

CloneLoop

Clone Once, Loop Forever — 从对话中克隆你的工作模式,让 AI 持续按你的标准执行

CloneLoop 是一个基于 MCP(Model Context Protocol) 的 AI 任务监督工具。它通过 interactive_feedback MCP 工具在 AI 和用户之间建立持续的反馈循环,确保 AI 完整地完成任务。

快速安装

~/.cursor/mcp.json 或项目 .cursor/mcp.json 中添加:

{
  "mcpServers": {
    "mcp-ai-supervisor": {
      "command": "uvx",
      "args": ["cloneloop"],
      "timeout": 600,
      "autoApprove": ["interactive_feedback"]
    }
  }
}

前置条件:安装 uv

验证安装:uvx cloneloop version

Cursor、Qoder、Claude Code 等支持 MCP 的工具均可使用相同配置。

核心特性

  • Tauri 桌面弹窗 — 原生弹窗提醒(macOS / Linux / Windows)
  • Workbench 控制台 — React + WebSocket 实时多项目管理面板
  • 技能炼化(Clone) — 从历史对话中自动提炼你的工作模式,生成个性化 Skill
  • 技能评测 — 评估炼化出的 Skill 有多像你的真实工作模式
  • 消息队列 — AI 忙碌时消息自动排队,空闲时优先投递
  • 多 IDE 支持 — Cursor、Qoder、Claude Code
  • 多语言界面 — 简体中文 / 繁体中文 / English

使用方式

在 Cursor 对话框输入 /cloneLoop 我们开始工作,AI 进入监工循环模式。

详细使用指南请参考 用户使用指南

系统架构

┌──────────────────────────────────────────────────────────┐
│                   Cursor / IDE 中的 AI                     │
│         调用 interactive_feedback MCP 工具                  │
└───────────────────────┬──────────────────────────────────┘
                        │ MCP Protocol (stdio)
┌───────────────────────▼──────────────────────────────────┐
│         MCP Server (packages/mcp-server)                   │
│   • interactive_feedback / get_system_info                 │
│   • DelegateManager 核心编排                                │
│   • WorkbenchClient → 上报消息到 Workbench                  │
└───────────────────────┬──────────────────────────────────┘
                        │ HTTP API
┌───────────────────────▼──────────────────────────────────┐
│      Workbench Server (packages/workbench-server)          │
│   REST API + WebSocket 实时通信                             │
└───────────────────────┬──────────────────────────────────┘
                        │ HTTP + WebSocket
┌───────────────────────▼──────────────────────────────────┐
│       Workbench UI (packages/workbench-ui)                 │
│   React 19 + TypeScript + Vite                              │
└──────────────────────────────────────────────────────────┘

项目结构

mcp-ai-supervisor/                     # Monorepo (uv workspace)
├── packages/
│   ├── core/                          # mcp-supervisor-core:基础设施
│   ├── mcp-server/                    # cloneloop:MCP Server 核心
│   ├── workbench-server/              # mcp-supervisor-workbench:Workbench 后端
│   ├── workbench-ui/                  # Workbench 前端
│   └── desktop/                       # Tauri 桌面应用
├── artifacts/desktop/                  # 预编译桌面应用二进制
├── tests/                             # 后端测试
├── scripts/                           # 安装/部署/工具脚本
└── docs/                              # 项目文档

开发

# 后端测试
.venv/bin/python3 -m pytest

# 前端开发
cd packages/workbench-ui && npm run dev

# 部署
bash scripts/deploy.sh

对话历史工具

# 查看项目列表
python scripts/dev/conversation_extract.py list

# 提取今天的对话
python scripts/dev/conversation_extract.py extract mcp-ai-supervisor --today

# 搜索对话
python scripts/dev/conversation_extract.py search "关键词"

技术栈

  • 后端: Python 3.11+, FastMCP, FastAPI, WebSocket
  • 前端: React 19, TypeScript, Vite 8, CSS Modules
  • 桌面: Tauri (Rust), 预编译二进制
  • 协议: MCP (Model Context Protocol)

许可证

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cloneloop-0.1.2-py3-none-any.whl (8.8 MB view details)

Uploaded Python 3

File details

Details for the file cloneloop-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: cloneloop-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 8.8 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.17

File hashes

Hashes for cloneloop-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 0de86d4e014e7139dea099c011c666c005c13a8175201745b603714df500a39c
MD5 b1d57025d7454513ceae9b1d13254147
BLAKE2b-256 f5f21b0e09dfd07963d8e8bf45319335076dfc5b6c0e8aa4b784d83f1f75029a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page