n8n-nodes-cursor-agent

面向 n8n 的社区节点包：Cursor Agent。通过 @cursor/sdk 在本机 local runtime 运行 Cursor Agent，支持配置 MCP 服务器、Skills 工作目录与 Redis 多轮会话。

• npm： n8n-nodes-cursor-agent
• 源码： https://github.com/liuhauyao/n8n-nodes-cursor-agent

前置条件

当前限制： 仅支持 local runtime，不支持 cloud agent。

安装

n8n 社区节点 UI

Settings → Community Nodes → Install → 输入 n8n-nodes-cursor-agent

Docker / 自托管

在 N8N_COMMUNITY_PACKAGES 或 ~/.n8n/nodes/package.json 中加入本包后重启 n8n。

宿主依赖（必配，符合 n8n 社区节点规范）

本包 不含 runtime dependencies（n8n 社区节点规范要求）。@cursor/sdk 及其 Linux 平台二进制需在 ~/.n8n/nodes 目录单独安装，与社区节点包同级解析：

{
  "dependencies": {
    "n8n-nodes-cursor-agent": "2.2.0",
    "@cursor/sdk": "1.0.13"
  },
  "optionalDependencies": {
    "@cursor/sdk-linux-x64": "1.0.13",
    "@cursor/sdk-linux-arm64": "1.0.13"
  }
}

在 ~/.n8n/nodes 执行 npm install 后重启 n8n。版本号须与 @cursor/sdk 一致。

节点内 Redis 访问使用 Node.js 内置 node:net（RESP 协议），不再依赖 redis npm 包。在 n8n 中配置 Redis 凭证（host/port/密码等）即可。

节点参数

Permission Preset（与 Claude Agent 对齐）

Cursor 与 Claude 的差异： Claude 通过 disallowedTools + dontAsk 拒绝执行但保留 tool 流式事件；Cursor 依赖 .cursor/cli.json 拒绝执行，SDK 仍会发出 tool-call-started 事件供 UI 展示。

工作区约定： mcp_skills_only / plan_only 会强制 settingSources: ['project']；Skills Root 宜指向含 .cursor/skills/ 与 .cursor/cli.json 的目录，具体 allow/deny 由你在该目录维护。

MCP Tool Filter（Options → MCP）

每次执行前将过滤规则合并进 Skills Root 下的 .cursor/cli.json（Mcp(server:tool) deny/allow）。

Skills

将 skill 放在工作目录下的 .cursor/skills/<skill-name>/SKILL.md，并把 Setting Sources 包含 project（默认已选）。

Skills Root Directory 应指向含 .cursor/skills/ 的仓库根；它会作为 local.cwd 的第一项，确保 skill 从指定根加载。

多工作目录示例

跨前后端仓库检索时：

SDK 收到 local.cwd: [frontend, frontend, backend] 去重后为 [frontend, backend]。

MCP 配置示例

表单（HTTP）

• Name: my-api
• Transport: HTTP
• URL: https://example.com/mcp
• Headers: Authorization = Bearer <token>

JSON 覆盖

{
  "my-api": {
    "type": "http",
    "url": "https://example.com/mcp",
    "headers": { "Authorization": "Bearer xxx" }
  },
  "local-tool": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "some-mcp-server"]
  }
}

Inline MCP 在 create、resume、send 时均需传入；本节点已自动处理。

输出字段

流式事件（__cursor__）

启用 n8n 流式响应时，节点通过 sendChunk 输出 JSON 行，marker 为 __cursor__：

输出字段

headless 模式下 Cursor SDK 不提供 AskQuestion / Todo 交互；节点会过滤相关回退文案，且不在工具链 UI 展示这些内部工具。

本地 POC

export CURSOR_API_KEY=...
export POC_CWD=/path/to/your/project
export POC_MCP_SERVERS_JSON='{"demo":{"type":"http","url":"https://example.com/mcp"}}'
npm run poc

开发

npm install
npm run verify   # build + eslint + package.json lint
npm run dev      # tsc --watch

相关文档

• Cursor SDK (TypeScript)
• Cursor MCP
• n8n Community Nodes