cursor-mcp-server

Ein MCP-Server, der das gesamte Schreiben von Code an Cursors Agents delegiert – Composer 2 (oder Grok 4.5). Entwickelt, damit ein PM-/Orchestrator-Modell – Claude, in dem Setup, für das dies gebaut wurde – niemals direkt Code schreibt. Er liest Kontext, zerlegt Arbeit in abgegrenzte Aufgaben und ruft das Agent-SDK von Cursor auf, um Dateien tatsächlich zu generieren oder zu bearbeiten.

Warum

Claudes Kontextfenster ist die knappe Ressource in einem Orchestrator-Workflow. Jede Codezeile, die Claude direkt schreibt, ist eine Zeile, die es in seinem eigenen Token-Budget halten, erneut lesen und bezahlen muss – und dieses Budget skaliert mit der Größe der Funktion, nicht mit der Komplexität der Aufgabenbeschreibung. Die Delegierung der Codegenerierung an Cursor entkoppelt die Kosten des Orchestrators von der Ausgabegröße: Ein cursor_write_code-Aufruf kostet ungefähr dasselbe, egal ob Cursor am Ende 20 Zeilen oder 400 produziert.

Cursors Preise pro Token sind außerdem erheblich günstiger als die eines Spitzen-Reasoning-Modells. Die Verlagerung der Massencodegenerierung dorthin ist daher ein sich verstärkender Vorteil, nicht nur ein Kontextfenster-Trick.

Related MCP server: local-llm-mcp

Architektur

Ein MCP-Server (@modelcontextprotocol/sdk), der zwei Tools bereitstellt, die beide auf Agent.prompt() von @cursor/sdk basieren:

• cursor_write_code – Erstellung neuer Dateien/Funktionen delegieren

• cursor_edit_code – Bearbeitungen an einer vorhandenen Datei delegieren

Beide Tools akzeptieren:

Der Server erstellt aus diesen Feldern einen einzigen Prompt und führt ihn mit Cursors Agent aus (local-Modus läuft auf deinem Rechner in workingDirectory; cloud-Modus läuft auf Cursors Sandbox-VMs).

Einrichtung

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

Umgebungsvariablen

Bei Claude Code / einem beliebigen MCP-Client registrieren

Füge es zu deiner MCP-Client-Konfiguration hinzu (z. B. .mcp.json oder 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" }
    }
  }
}

Modellauswahl

• composer (Standard) – Composer 2. Schnell und zuverlässig für klar spezifizierte, mechanische Aufgaben: CRUD, Scaffolding, kleine Änderungen, das Befolgen eines bereits klaren Musters.

• grok – Grok 4.5. Leistungsfähiger, teurer. Für komplexes Reasoning, knifflige Refactorings, architektursensible Änderungen reservieren – oder wenn ein Composer-Lauf falsche/verwirrte Ergebnisse lieferte. Verwende effort: "high" für die schwierigsten Fälle.

Orchestrator-Vertrag

Dieser Server ist dafür gedacht, mit einem Systemprompt bzw. einer CLAUDE.md kombiniert zu werden, die die Codegenerierung strikt durch ihn erzwingt:

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.

Die Aufgabe des Orchestrators bleibt: Aufgaben in abgegrenzte Teilaufgaben zu zerlegen, Schnittstellen/Verträge zu definieren, bevor Composer sie schreibt, Ausgaben auf Korrektheit zu prüfen und zu entscheiden, was als Nächstes gebaut wird. Die eigentliche Codegenerierung läuft vollständig in Cursors Agent-Schleife ab.

Überprüfe das, was zurückkommt, immer unabhängig. Vertraue einer Abschlussmeldung nicht ungeprüft – öffne die Datei, führe die Tests aus, prüfe den Diff. Ein selbst gemeldetes „done“ eines Sub-Agents ist kein Beweis.

Skripte

Lizenz

MIT – siehe LICENSE.