cursor-mcp-server

一个 MCP 服务器，将所有代码编写工作委托给 Cursor 的 Composer 2（或 Grok 4.5）代理。它的设计目标是让 PM/编排器模型——在本项目为之构建的配置中，也就是 Claude——永远不直接编写代码。它会读取上下文、将工作拆分为范围明确的任务，并调用 Cursor 的 agent SDK 来真正生成或编辑文件。

为什么

在编排器工作流中，Claude 的上下文窗口才是最稀缺的资源。Claude 每直接写下一行代码，它就必须在自己的 token 预算中保存这行代码、重新读取它、并为它付费——而这个预算随功能规模增长，与任务描述的复杂程度无关。将代码生成委托给 Cursor，可以把编排器的成本与输出规模解耦：一次 cursor_write_code 调用，无论 Cursor 最终产出 20 行还是 400 行，成本都大致相同。

Cursor 的按 token 定价也比前沿推理模型便宜得多，因此把大批量代码生成迁移过去是一笔复利式收益，而不仅仅是上下文窗口上的小技巧。

Related MCP server: local-llm-mcp

架构

基于 @modelcontextprotocol/sdk 的一个 MCP 服务器，对外暴露两个工具，二者都由 @cursor/sdk 的 Agent.prompt() 驱动：

• cursor_write_code —— 委托创建新文件/新功能

• cursor_edit_code —— 委托编辑现有文件

两个工具都接受以下字段：

服务器会根据这些字段构建出一条提示词，并将其交给 Cursor 的代理运行（local 模式在你机器上的 workingDirectory 中执行；cloud 模式在 Cursor 的沙箱虚拟机上运行）。

设置

npm install
cp .env.example .env
# edit .env: set CURSOR_API_KEY (Cursor dashboard -> Integrations -> API Keys)
npm run build

环境变量

在 Claude Code / 任意 MCP 客户端中注册

将其添加到你的 MCP 客户端配置中（例如 .mcp.json 或 claude mcp add）：

{
  "mcpServers": {
    "cursor-coder": {
      "command": "node",
      "args": ["/absolute/path/to/cursor-mcp-server/dist/index.js"],
      "env": { "CURSOR_API_KEY": "your_cursor_api_key_here" }
    }
  }
}

模型选择

• composer（默认）——Composer 2。对于定义明确、机械性的任务，它快速且可靠：CRUD、脚手架、小改动、遵循已有清晰模式。

• grok——Grok 4.5。能力更强，价格更高。请留给复杂推理、棘手的重构、对架构敏感的改动，或当 Composer 返回错误/混乱结果时使用。最困难的情况下使用 effort: "high"。

编排器契约

该服务器旨在搭配一个系统提示词 / CLAUDE.md 使用，它会将代码生成硬性限制为必须经由它完成：

You are the architect and project manager. Cursor Composer 2 is your
code-writing sub-agent.

- NEVER write code yourself. No code blocks, no file edits.
- For ALL code generation -> call cursor_write_code.
- For ALL code edits -> call cursor_edit_code.
- You MAY read files to understand context before delegating.
- You MAY review Composer's output and ask it to revise via another
  tool call.

编排器的职责保持不变：将任务拆分为有明确范围的子任务、在 Composer 编写之前定义接口/契约、审查输出以保证正确性，并决定接下来要构建什么。实际的代码生成完全在 Cursor 的代理循环中运行。

始终独立复核返回的结果。 不要轻信完成消息的表面说法——打开文件、运行测试、检查 diff。子代理自称的“done”并不是证据。

脚本

许可证

MIT —— 参见 LICENSE。