cursor-mcp-server

모든 코드 작성을 Cursor의 Composer 2(또는 Grok 4.5) 에이전트에 위임하는 MCP 서버입니다. 이 서버가 만들어진 환경에서는 PM/오케스트레이터 모델인 Claude가 코드를 직접 작성하지 않도록 설계되었습니다. 컨텍스트를 읽고, 작업을 범위가 한정된 태스크로 나누고, 실제 파일 생성이나 수정은 Cursor의 에이전트 SDK에 요청합니다.

왜

오케스트레이터 워크플로에서 Claude의 컨텍스트 윈도우는 가장 부족한 리소스입니다. Claude가 직접 작성하는 모든 코드 줄은 Claude가 자신의 토큰 예산에서 보유하고 다시 읽고 비용을 지불해야 하는 줄이며, 그 예산은 작업 설명의 복잡성이 아니라 기능의 규모에 비례합니다. 코드 생성을 Cursor에 위임하면 오케스트레이터의 비용이 출력 크기에서 분리됩니다. cursor_write_code 호출은 Cursor가 결국 20줄을 생성하든 400줄을 생성하든 비용이 거의 같습니다.

또한 Cursor의 토큰당 가격은 프런티어 추론 모델보다 훨씬 저렴하므로, 대량 코드 생성을 Cursor로 옮기는 것은 단순한 컨텍스트 윈도우 꼼수가 아니라 복리 효과가 있는 이득입니다.

Related MCP server: local-llm-mcp

아키텍처

단일 MCP 서버(@modelcontextprotocol/sdk)가 두 개의 도구를 노출하며, 두 도구 모두 @cursor/sdk의 Agent.prompt()를 기반으로 합니다:

• cursor_write_code - 새 파일/기능 생성 위임

• cursor_edit_code - 기존 파일 편집 위임

두 도구 모두 다음 필드를 받습니다:

서버는 이 필드들로 단일 프롬프트를 구성하고, 이를 Cursor의 에이전트에서 실행합니다(local 모드는 사용자 머신의 workingDirectory에서 실행되고, cloud 모드는 Cursor의 샌드박스 VM에서 실행됩니다).

설정

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를 참조하세요.