克劳德-光标MCP编排器

先进的编排系统，用于在Claude Desktop与Cursor AI之间实现双向AI工作流管理。

这是什么？

这个MCP（模型上下文协议）服务器使Claude Desktop能够在Cursor AI中协调和管理任务，从而构建了一个强大的双向AI工作流系统。

特点/功能

18款强大工具 用于任务管理和编排，包括 克劳德监督员
6个资源 包括实时指标、实时更新， 沟通指南，和 冲刺模板
2个MCP提示 用于工作流生成和 专业的冲刺计划（或：专业冲刺规划）
基于SQLite的 持久状态管理
Git 集成 支持自动提交
并发任务执行 具有可配置的限制
活动记录 以及监测
重试机制 采用指数退避（或指数回退）策略
任务模板 用于可重用的工作流
路径验证 为了安全起见（默认禁用）
实时指标 以及分析（或分析工具）
双向通信 - 克劳德 ↔ 交响乐指挥者 ↔ 光标AI
文件监视器 - 自动监控API文件
实时仪表板 - 实时任务可视化
克劳德监督员 - 自动任务验证和修正

可用工具

核心工具

执行游标任务 - 提交任务给Cursor AI执行
获取任务状态 - 检查任务状态
获取项目状态 - 获取全面的项目状态
列出项目任务 - 列出所有项目任务并进行筛选
取消任务 - 取消挂起/正在运行的任务
获取活动日志 - 查看活动历史记录
获取系统统计信息 - 获取系统级统计信息

高级工具

重试任务 - 对失败的任务使用指数退避策略重试
保存任务模板 - 将任务保存为可重用的模板
列出任务模板 - 列出所有已保存的模板
根据模板创建任务 - 从模板创建任务
删除任务模板 - 删除已保存的模板
监控API通信 - 监控与Cursor AI的双向通信
开始关注项目 开始自动监控API文件
停止关注项目 停止监控API文件
获取观看状态 - 获取监控项目的列表
监督光标任务 - 克劳德作为监督者 - 优化并改进Cursor AI
创建光标规则 - 创建/更新 .cursorrules 文件

资源

编曲器://项目 - 列出所有管理的项目
编曲器://日志 - 最近的系统日志
编排器://实时更新 - 实时更新流（兼容SSE）
编排器://指标 - 实时性能指标
编曲者://沟通指南 - Claude-Cursor通信完整指南
编排器://冲刺模板 - 专业冲刺计划模板（MTQuant风格）

提示

编排工作流提示 - 为一个目标生成工作流程
冲刺生成器提示 - 生成包含每日详细分解的专业冲刺计划

安装

先决条件

Python 3.10及以上版本
紫外线包管理器
Claude Desktop（可译为“Claude桌面版”或保持原样，根据上下文判断是否需要具体翻译）
Cursor AI（可选，以实现全部功能）

设置

克隆仓库：

git clone https://github.com/jeden-/claude_cursor_mcp.git
cd claude_cursor_mcp

安装依赖项：

uv init
uv add "mcp[cli]"
uv add aiofiles watchdog

配置Claude桌面版：

编辑您的Claude桌面配置文件：

macOS（苹果电脑操作系统）： ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux（发音类似“林克斯”）: ~/.config/Claude/claude_desktop_config.json

添加此配置：

{
  "mcpServers": {
    "cursor-orchestrator": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/path/to/claude_cursor_mcp",
        "run",
        "cursor_orchestrator_advanced.py"
      ]
    }
  }
}

重要的使用完整路径！找到你的 uv 路径与： which uv

重启Claude桌面版

🎨 光标集成

调度器与Cursor集成在 指令模式 默认情况下：

任务创建当你执行一个任务时，它会创建一个 .cursor-tasks/task_.md 文件
自动打开在Cursor中自动打开项目和任务文件
手动执行你使用Cursor的AI功能（Cmd+K或Cmd+L）来执行任务
状态跟踪任务状态在编排器中进行跟踪

配置模式

在 Config 班级/课程：

CURSOR_MODE = "api" (默认) - 双向通信 在Claude Desktop和Cursor AI之间
CURSOR_MODE = "instruction" - 创建手动执行的任务文件
CURSOR_MODE = "auto" - 创建带有自动执行提示的任务文件
CURSOR_MODE = "mock" - 模拟执行以进行测试
AUTO_OPEN_CURSOR = True - 自动使用任务文件打开Cursor

🤖 API模式 - 双向通信

API模式使Claude Desktop与Cursor AI之间能够实现自动通信：

Claude Desktop（可译为“Claude桌面版”或根据具体语境简化为“Claude桌面”） 通过编排器发送任务
编曲家（或指挥家，根据上下文，此处“Orchestrator”可能指负责乐队指挥或音乐编排的人） 创建任务文件+API通信文件
Cursor AI 执行任务并更新API文件以显示进度
指挥者（或“编曲者”，根据上下文具体含义可调整） 监控进度并向Claude Desktop报告
Claude Desktop（可译为“Claude桌面版”或保持原样，根据上下文决定是否需要具体化为某种软件或平台的名称） 接收实时更新

创建的文件：

task_xxx.md - 任务说明
api_xxx.json - 带状态/进度的沟通文件

新工具： monitor_api_communication(task_id) - 监控实时进度

📖 通信指南 - 内置上下文

无需再手动设置上下文！ 协调器包含一份全面的通信指南，作为MCP（可能是指某种管理或控制平台）的资源：

在Claude桌面版中的访问方式： 克劳德可以自动阅读 orchestrator://communication-guide 获取完整的关于如何：的说明

将任务发送给Cursor AI
选择合适的通信方式（单任务、复选框、API模式）
监控进度并接收反馈
使用 supervise_cursor_task 进行自动验证
应用最佳实践

这意味着：

✅ 无需在每次对话中手动粘贴指令
✅ 克劳德总是了解最新的沟通模式
✅ 所有项目采用一致的工作流程
✅ 当您修改指南时，自动更新

Claude Desktop 将自动使用此资源 需要的时候！

冲刺生成器 - 专业发展计划

基于生产项目中已验证的模式（MTQuant风格）！

现在的协调器包含了一个强大的冲刺规划系统，该系统能够生成 日复一日的发展计划 配备即用型Cursor AI提示。

特点：

📅 日期/日历 逐日详细分析/分解 - 为期7-14天的冲刺活动的组织结构
⏱️（表示时间流逝或计时的符号，可译为“时间流逝”或根据上下文译为“计时”等，此处不直接翻译符号，仅说明其含义） 时间估算 - 每个任务都有合理的时间分配（30-120分钟）
📋（清单/待办事项列表） 即用型提示 - 复制粘贴光标AI指令
✅ 验证检查清单 - 为每项任务设定明确的成功标准
🎯 目标 预期结果 - 每项任务完成后应该做什么
🔗（此符号在中文中通常表示链接，但无具体含义，可直接保留或根据上下文替换为“链接”等表述） 编曲器集成 - 与 execute_cursor_task() 的直接集成

使用方法：

1. 制定冲刺计划：

Use prompt: sprint_generator_prompt(
    project_name="MyApp",
    sprint_goal="Build user authentication system",
    duration_days=7,
    tech_stack="FastAPI, PostgreSQL, JWT",
    prerequisites="Python 3.11, Docker installed"
)

2. 获取模板：

Read: orchestrator://sprint-template

3. 执行冲刺任务：

execute_cursor_task(
    project_path="/path/to/project",
    command="[Copy Cursor AI Prompt from sprint plan]",
    priority="high"
)

4. 监控进度：

get_task_status(task_id="task_xxx")
start_watching_project(project_path="/path/to/project")

冲刺结构：

DAY 1 - Foundation
  Task 1.1: Project structure (30 min)
    ✅ Cursor AI Prompt: [Ready to copy]
    ✅ Verification: [Checklist]
    ✅ Expected Outcome: [Clear goal]
  
  Task 1.2: Database setup (60 min)
    ...

DAY 2 - Core Features
  Task 2.1: User model (45 min)
    ...

生成的冲刺（sprints）中的示例提示：

**Cursor AI Prompt:**

为FastAPI后端创建用户认证模块。

要求：

基于JWT令牌的身份验证
使用 bcrypt 进行密码哈希处理
邮箱/密码登录接口
令牌刷新端点

实施：

from fastapi import APIRouter, Depends
from pydantic import BaseModel, EmailStr

router = APIRouter(prefix="/auth")

class LoginRequest(BaseModel):
    email: EmailStr
    password: str

@router.post("/login")
async def login(request: LoginRequest):
    # Implementation here
    pass

测试：

用于测试用户的 pytest 固件
测试成功登录
测试无效凭据
测试令牌验证

好处：

✅ 不再有规划的开销 - 克劳德生成详细计划
✅ 经证实的结构 - 基于实际生产项目
✅ 已准备好复制粘贴 - 提示词直接与Cursor AI协同工作
✅ 可追踪的进展 - 内置验证和监控
✅ 品质稳定 - 内置最佳实践

Claude Supervisor - Claude收购Cursor AI

你的梦想实现了！ 克劳德扮演着监督者的角色，他：

委托任务 “Cursorowi” 可以翻译为“光标爱好者”或“光标追随者”，具体取决于上下文和语境。如果是指对光标操作或光标设计有特别兴趣或关注的人群，这样的翻译比较贴切。
检查结果 根据验收标准
发现错误 “i braki” 可以翻译为“我的缺点”或“我的不足之处”。这里，“i”是第一人称单数代词，表示“我”，“braki”是波兰语中的词汇，意为“缺点”或“不足”
自动修正 - 重新提交任务，附上修正内容
迭代（Iteruje） 直到成功（最多3次）
报告（或：陈述） 所有的迭代和最终结果

使用示例：

supervise_cursor_task(
    project_path="/Users/mariusz/amgsquant",
    task_description="Stwórz formularz logowania w React",
    acceptance_criteria=[
        "Formularz ma pola email i password",
        "Jest walidacja formatu email",
        "Hasło ma minimum 8 znaków",
        "Jest obsługa błędów API",
        "Są testy jednostkowe"
    ],
    max_iterations=3
)

工作流程：

TY → Claude: "Stwórz formularz logowania"
  ↓
Claude → Cursor: "Create login form..."
  ↓
Cursor → tworzy kod
  ↓
Claude → sprawdza:
  ❌ "Brakuje walidacji email"
  ❌ "Nie ma error handling"
  ↓
Claude → Cursor: "Dodaj walidację i error handling"
  ↓
Cursor → poprawia
  ↓
Claude → sprawdza ponownie:
  ✅ "Wszystko OK!"
  ↓
Claude → Ty: "Formularz gotowy! ✅"

这正是你想要的！ 🎉

全自动化

具备双向通信功能的全自动工作流程：

文件监视器（内置）

自动监控 .cursor-tasks/ API文件更改的目录
检测Cursor AI更新任务进度时的情况
实时更新数据库中的任务状态
通过SSE通知Claude Desktop有关更改

自动执行脚本（用于测试）

uv run python cursor_auto_executor.py /path/to/project

等待新任务 .cursor-tasks/
自动“执行”任务（模拟）
更新API文件进度（10%，30%，60%，90%，100%）
用于测试通信流程

实时仪表板

uv run python dashboard_server.py

然后在浏览器中打开 http://localhost:8080：

从SQLite数据库进行实时任务监控
统计数据和成功率
受监查项目清单
最近任务状态
每5秒自动刷新

监控工具：

start_watching_project(project_path) - 开始自动监控
stop_watching_project(project_path) - 停止监控
get_watching_status() - 列出受监控的项目
monitor_api_communication(task_id) - 监控特定任务
orchestrator://live-updates - SSE（Server-Sent Events）更新流

如何在Cursor中执行任务

方法1：Cmd+K（Composer）

在Cursor中打开任务文件
新闻界；媒体 Cmd+K
类型： Zaimplementuj to zadanie zgodnie z instrukcjami
Cursor AI 将执行代码

方法2：Cmd+L（聊天）

新闻界；媒体 Cmd+L
类型： Przeczytaj plik zadania i zaimplementuj schemat
Cursor AI将进行分析并执行

方法3：自动模式 设置 CURSOR_MODE = "auto" 对于包含内置执行提示的任务文件。

Cursor CLI 位置

协调器自动使用来自以下位置的 Cursor CLI：

/Applications/Cursor.app/Contents/Resources/app/bin/cursor

🧪 使用MCP Inspector进行测试

uv run mcp dev cursor_orchestrator_advanced.py

在 http://localhost:6274 打开交互式浏览器界面

📖 使用示例

基本任务执行

在Claude Desktop中：

Execute a task in project /Users/me/myapp:
- Description: Add dark mode support
- Priority: high

系统监控

Show me system stats and all active projects

工作流生成

Generate workflow for project MyApp with goal: Implement user authentication

⚙️ 配置

编辑 Config 班级里 cursor_orchestrator_advanced.py:

class Config:
    MAX_CONCURRENT_TASKS = 3     # Max parallel tasks
    TASK_TIMEOUT = 300           # 5 minutes
    GIT_AUTO_COMMIT = True       # Auto-commit changes
    CURSOR_MODE = "instruction"  # "instruction", "mock", or "api"
    
    # Path validation (empty list = allow all)
    ALLOWED_PROJECT_PATHS = []   # Disabled by default
    # Or specify allowed directories:
    # ALLOWED_PROJECT_PATHS = [
    #     Path.home() / "projects",
    #     Path.home() / "your-folder",
    # ]

🔒 路径安全

默认情况下，路径验证是 残疾的 （ALLOWED_PROJECT_PATHS = []以提供最大灵活性。

要启用路径限制，请取消注释并配置允许的目录在 Config 班级。

📊 系统架构

状态管理器基于SQLite的持久化存储
任务执行器异步任务队列与执行
光标接口Cursor CLI 集成
Git接口Git 操作
FastMCPMCP服务器框架

📁 项目结构

claude_cursor_mcp/
├── cursor_orchestrator_advanced.py  # Main MCP server code
├── dashboard_server.py              # Live dashboard HTTP server
├── dashboard.html                   # Real-time monitoring UI
├── cursor_auto_executor.py          # Testing script (simulates Cursor AI)
├── claude_supervisor.py             # Example supervisor usage
├── orchestrator_setup_guide.md      # Detailed setup guide
├── orchestrator_config_files.md     # Additional config examples
├── pyproject.toml                   # Project dependencies
├── uv.lock                          # Locked dependencies
└── README.md                        # This file

🗄️ 数据库

状态存储于： ~/.claude-cursor-orchestrator/state.db

桌子：

任务 - 任务历史和状态
项目 - 项目状态
活动日志 - 系统活动
任务模板 - 可重复使用的任务模板

📝 日志

系统日志： ~/.claude-cursor-orchestrator/orchestrator.log

🔧 故障排除

“spawn uv ENOENT” 错误

使用完整路径到 uv 在配置中（使用以下方式查找） which uv）

未找到 Cursor CLI

从以下链接安装：https://cursor.com/install

端口冲突

仅运行一个实例（要么是Inspector，要么是Claude Desktop集成）

📚 文档

查看详细指南：

设置指南 - 完整的安装指南
配置文件 - 额外配置

🤝 贡献（或：参与贡献）

欢迎贡献！请随时提交问题和拉取请求。

📄 许可证

MIT 许可证 - 欢迎在您的项目中自由使用！

🙏 致谢

构建于：

MCP SDK（MCP软件开发工具包）由Anthropic开发
FastMCP 框架
紫外线由Astral（星界/星体）

如果觉得有用，请点赞

如果这个项目对您有帮助，请考虑给它点个星吧！

______________________________________________________________________

专为人工智能开发社区打造

Claude cursor MCP

快速接入

详细介绍