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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0de86d4e014e7139dea099c011c666c005c13a8175201745b603714df500a39c
|
|
| MD5 |
b1d57025d7454513ceae9b1d13254147
|
|
| BLAKE2b-256 |
f5f21b0e09dfd07963d8e8bf45319335076dfc5b6c0e8aa4b784d83f1f75029a
|