Cursor 动态工作流

将 Cursor 用作 you-agent-factory Factory Session 与动态工作流工具的 MCP 主机。

是什么

Cursor 动态工作流是指将 Cursor 用作 you-agent-factory 的 Model Context Protocol (MCP) 主机。Cursor 将 you mcp serve 作为子进程启动,然后调用用于验证、启动和检查 JavaScript 或 TypeScript 动态工作流的 Factory Session 工具。在本产品中,动态工作流是由 JavaScript 编排器驱动的工厂;活跃运行仍是 Factory Session。MCP 路径把这些工作留在编辑器内,而不是每次验证、启动或查看状态都切换到单独终端。

何时使用

当你从 Cursor 编写或驱动 JavaScript 或 TypeScript 动态工作流,并希望在编辑器中将 Factory Session 工具作为 MCP 工具使用时,请走这条路径。当你只需要 CLI 的安装 → 运行 → 提交路径、不需要 Cursor 调用 Factory Session 工具时,优先使用不带 MCP 的普通工厂循环与提交批次。当你的编辑器或代理不是 Cursor(即使它也支持 MCP)时,优先使用其他 MCP 主机指南。

步骤或工作流

确认已安装 you CLI,为 you mcp serve 添加 Cursor Model Context Protocol (MCP) 服务器条目,重新加载 Cursor 以使子进程启动,然后运行第一个 Factory Session 循环:验证源、启动会话,并检查状态或结果。

Cursor MCP 配置位置

当工作流位于该仓库时,将服务器条目放在项目文件 .cursor/mcp.json;若希望跨项目使用同一服务器,则放在全局文件 ~/.cursor/mcp.json。对于一个工作流根目录,项目配置通常已足够。

Cursor MCP 服务器条目示例

{
  "mcpServers": {
    "you-agent-factory": {
      "command": "/absolute/path/to/you",
      "args": ["mcp", "serve"],
      "cwd": "/absolute/path/to/project"
    }
  }
}
当 Cursor 看不到你的 shell PATH 时,将 command 替换为 you 二进制的绝对路径。保持 args 为 mcp serve。将 cwd 设为工作流项目根目录以便解析源。保存文件后,重启 Cursor 或运行 Developer: Reload Window,使 Cursor 重新生成 MCP 子进程。

从 Cursor 发起的首次 Factory Session 循环

重新加载后,确认 Cursor 中出现 Factory Session 工具。优先使用 you.factory_session.* 名称。若主机仍列出较旧的 you.workflow.* 别名,它们仍会解析到相同处理程序。

验证工作流源

you.factory_session.validate_source
对你的 JavaScript 或 TypeScript 编排器源调用 you.factory_session.validate_source。兼容别名:you.workflow.validate。验证通过可确认 Cursor 已到达 you mcp serve,且项目 cwd 能解析工作流。

启动 Factory Session

you.factory_session.start_async
需要轮询时用 you.factory_session.start_async 启动一个会话,需要工具等待完成时用 you.factory_session.start_sync。同步启动的兼容别名:you.workflow.run。

检查状态与结果

you.factory_session.get
you.factory_session.get_result
用 you.factory_session.get 读取进度,会话就绪后用 you.factory_session.get_result 读取结果。兼容别名:you.workflow.status 与 you.workflow.result。该验证 → 启动 → 状态或结果路径足以证明 Cursor 集成。完整工具目录、运行时支持的 serve 标志与动态工作流 API 细节见 MCP 与动态工作流文档页。完成本次首次循环无需打开那些页面。

常见陷阱

若 Cursor 在 PATH 上找不到 you,请将 command 设为 you 二进制的绝对路径,而不是依赖 shell PATH。若 validate 或 start 无法解析工作流源,请检查 cwd 是工作流项目根目录,而不是嵌套包或主目录。更改 MCP 配置后,请重启 Cursor 或运行 Developer: Reload Window,以便 MCP 子进程重新生成;仅保存文件不够。将本指南仅视为首次 Cursor 集成循环 — 完整工具目录、serve 标志与动态工作流 API 细节见下方链接的 MCP 与动态工作流文档页。

标签