cursor-mcp-server

MCP-сервер, который делегирует всё написание кода агентам Composer 2 (или Grok 4.5) от Cursor. Создан так, чтобы модель PM/оркестратора — в конфигурации, для которой он создавался, это Claude, — никогда не писала код напрямую. Он читает контекст, разбивает работу на задачи с чёткими границами и обращается к агентному SDK Cursor, чтобы фактически генерировать или редактировать файлы.

Зачем

Контекстное окно Claude — это дефицитный ресурс в рабочем процессе оркестратора. Каждая строка кода, которую Claude пишет напрямую, — это строка, которую ему приходится удерживать, перечитывать и оплачивать из собственного бюджета токенов; этот бюджет растёт с размером функциональности, а не со сложностью описания задачи. Делегирование генерации кода Cursor отвязывает стоимость оркестратора от объёма вывода: вызов cursor_write_code стоит примерно одинаково, независимо от того, создаст ли Cursor в итоге 20 строк или 400.

Цены Cursor за токен также существенно ниже, чем у передовой модели рассуждений, так что перенос массовой генерации кода туда — это накопительный выигрыш, а не просто трюк с контекстным окном.

Related MCP server: local-llm-mcp

Архитектура

Один MCP-сервер (@modelcontextprotocol/sdk), предоставляющий два инструмента, оба основаны на Agent.prompt() из @cursor/sdk:

• 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. Сообщение субагента о том, что он «готов», — не доказательство.

Скрипты

Лицензия

MIT — см. LICENSE.