cursor-mcp-server

Un servidor MCP que delega toda la escritura de código en los agentes Composer 2 (o Grok 4.5) de Cursor. Está diseñado para que un modelo PM/orquestador —Claude, en la configuración para la que se creó— nunca escriba código directamente. Lee el contexto, divide el trabajo en tareas acotadas y recurre al SDK de agentes de Cursor para generar o editar realmente los archivos.

Por qué

La ventana de contexto de Claude es el recurso escaso en un flujo de trabajo de orquestación. Cada línea de código que Claude escribe directamente es una línea que tiene que retener, releer y pagar de su propio presupuesto de tokens —y ese presupuesto escala con el tamaño de la funcionalidad, no con la complejidad de la descripción de la tarea—. Delegar la generación de código en Cursor desvincula el coste del orquestador del tamaño de la salida: una llamada a cursor_write_code cuesta prácticamente lo mismo tanto si Cursor acaba produciendo 20 líneas como 400.

El precio por token de Cursor también es sustancialmente más barato que el de un modelo de razonamiento de frontera, así que trasladar allí la generación masiva de código es una ventaja que se acumula, no solo un truco de ventana de contexto.

Related MCP server: local-llm-mcp

Arquitectura

Un único servidor MCP (@modelcontextprotocol/sdk) que expone dos herramientas, ambas respaldadas por Agent.prompt() de @cursor/sdk:

• cursor_write_code - delega la creación de archivos/funcionalidades nuevos

• cursor_edit_code - delega las ediciones en un archivo existente

Ambas herramientas aceptan:

El servidor construye un único prompt a partir de estos campos y lo ejecuta contra el agente de Cursor (el modo local se ejecuta en tu máquina dentro de workingDirectory; el modo cloud se ejecuta en las máquinas virtuales aisladas de Cursor).

Configuración

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

Variables de entorno

Registro con Claude Code / cualquier cliente MCP

Añádelo a la configuración de tu cliente MCP (p. ej. .mcp.json o 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" }
    }
  }
}

Selección de modelo

• composer (por defecto) - Composer 2. Rápido y fiable para tareas mecánicas y bien especificadas: CRUD, scaffolding, ediciones pequeñas, seguir un patrón ya claro.

• grok - Grok 4.5. Más capaz, más caro. Resérvalo para razonamientos complejos, refactorizaciones delicadas, cambios sensibles a la arquitectura o cuando una ejecución de Composer haya devuelto algo incorrecto o confuso. Usa effort: "high" para los casos más difíciles.

Contrato del orquestador

Este servidor está pensado para usarse junto con un system prompt / CLAUDE.md que obligue a que toda la generación de código pase por él:

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.

El trabajo del orquestador sigue siendo: dividir las tareas en subtareas acotadas, definir interfaces/contratos antes de que Composer los escriba, revisar la corrección de los resultados y decidir qué construir a continuación. La generación de código real se ejecuta íntegramente dentro del bucle de agente de Cursor.

Verifica siempre de forma independiente lo que devuelva. No te tomes un mensaje de finalización al pie de la letra: abre el archivo, ejecuta los tests, revisa el diff. Que un subagente se declare «done» no es evidencia.

Scripts

Licencia

MIT - consulta LICENSE.