Cursor MCP (Protocolo de contexto de modelo)

Cursor MCP es un puente entre la aplicación de escritorio de Claude y el editor de Cursor, lo que permite una automatización fluida basada en IA y la gestión de múltiples instancias. Forma parte del ecosistema más amplio del Protocolo de Contexto de Modelo (MCP), lo que permite a Cursor interactuar con diversos modelos y servicios de IA mediante interfaces estandarizadas.

Descripción general

🤖 Integración de IA

• Integración directa con la aplicación de escritorio de Claude

• Capacidad de aprovechar otros servicios de IA compatibles con MCP

• Intercambio de contexto en tiempo real entre la IA y el editor

• Automatización y generación de código impulsadas por IA

🔌 Compatibilidad con el protocolo MCP

• Comunicación estandarizada con modelos de IA

• Sistema de complementos extensible para MCP adicionales

• Ejecución de comandos según el contexto

• Autenticación segura basada en tokens

🖥️ Gestión de ventanas multiplataforma

• Administre sin problemas las ventanas del editor del cursor en todos los sistemas operativos

• Enfocar, minimizar, restaurar y organizar ventanas mediante programación

• Realizar un seguimiento de los cambios de estado y posiciones de las ventanas

• Manejar múltiples instancias de Cursor simultáneamente

⌨️ Automatización de entrada

• Entrada de teclado impulsada por IA con soporte para:

  • Generación e inserción de código

  • Operaciones de refactorización

  • Finalizaciones según el contexto

  • Edición con múltiples cursores

• Automatización inteligente del mouse que incluye:

  • Selección inteligente

  • Operaciones del menú contextual

  • Navegación guiada por IA

🔄 Gestión de procesos

• Gestión de instancias orquestada por IA

• Organización inteligente del espacio de trabajo

• Preservación automática del contexto

• Recuperación de sesión inteligente

Integración MCP

Integración de escritorio de Claude

Uso de múltiples MCP

Integración de MCP personalizada

Configuración

La herramienta se puede configurar a través de variables de entorno o un archivo de configuración en:

• Ventanas: %LOCALAPPDATA%\cursor-mcp\config\config.json

• macOS: ~/Library/Application Support/cursor-mcp/config/config.json

• Linux: ~/.config/cursor-mcp/config.json

Ejemplo de configuración:

Instalación

Ventanas

macOS

Linux

Uso

Uso básico

Gestión de ventanas

Automatización de entrada

Cómo funciona

Arquitectura de puentes

Esta herramienta actúa como una capa de middleware entre Cursor y los servidores MCP:

1. Integración del cursor :

   • Monitorea los eventos del sistema de archivos del cursor

   • Captura el estado y el contexto del editor.

   • Inyecta respuestas nuevamente en el editor

   • Gestiona la automatización de ventanas y procesos.

2. Traducción del protocolo MCP :

   • Traduce los eventos internos del Cursor en mensajes de protocolo MCP

   • Convierte las respuestas de MCP en acciones compatibles con el cursor

   • Mantiene el estado y el contexto de la sesión.

   • Maneja la autenticación y la seguridad

3. Comunicación del servidor :

   • Se conecta al servidor MCP de la aplicación de escritorio de Claude

   • Envía solicitudes a los proveedores de IA adecuados

   • Administra conexiones simultáneas a múltiples MCP

   • Maneja los retrocesos y la recuperación de errores

Ejemplo de flujo de trabajo

1. Solicitud de finalización de código :

   // 1. Cursor Event (File Change) // When user types in Cursor: function calculateTotal(items) { // Calculate the total price of items| <-- cursor position // 2. Bridge Translation const event = { type: 'completion_request', context: { file: 'shopping-cart.ts', line: 2, prefix: '// Calculate the total price of items', language: 'typescript', cursor_position: 43 } } // 3. MCP Protocol Message await mcpServer.call('generate_completion', { prompt: event.context, max_tokens: 150, temperature: 0.7 }) // 4. Response Translation // Bridge converts MCP response: const response = `return items.reduce((total, item) => { return total + (item.price * item.quantity); }, 0);` // 5. Cursor Integration // Bridge injects the code at cursor position

2. Refactorización de código :

   // 1. Cursor Event (Command) // User selects code and triggers refactor command const oldCode = ` if (user.age >= 18) { if (user.hasLicense) { if (car.isAvailable) { rentCar(user, car); } } } ` // 2. Bridge Translation const event = { type: 'refactor_request', context: { selection: oldCode, command: 'simplify_nesting' } } // 3. MCP Protocol Message await mcpServer.call('refactor_code', { code: event.context.selection, style: 'simplified', maintain_logic: true }) // 4. Response Translation const response = ` const canRentCar = user.age >= 18 && user.hasLicense && car.isAvailable; if (canRentCar) { rentCar(user, car); } ` // 5. Cursor Integration // Bridge replaces selected code

3. Contexto de múltiples archivos :

   // 1. Cursor Event (File Dependencies) // When user requests help with a component // 2. Bridge Translation const event = { type: 'context_request', files: { 'UserProfile.tsx': '...', 'types.ts': '...', 'api.ts': '...' }, focus_file: 'UserProfile.tsx' } // 3. MCP Protocol Message await mcpServer.call('analyze_context', { files: event.files, primary_file: event.focus_file, analysis_type: 'component_dependencies' }) // 4. Response Processing // Bridge maintains context across requests

Métodos de integración

1. Monitoreo del sistema de archivos :

   import { FileSystemWatcher } from 'cursor-mcp/watcher' const watcher = new FileSystemWatcher({ paths: ['/path/to/cursor/workspace'], events: ['change', 'create', 'delete'] }) watcher.on('change', async (event) => { const mcpMessage = await bridge.translateEvent(event) await mcpServer.send(mcpMessage) })

2. Integración de ventanas :

   import { CursorWindow } from 'cursor-mcp/window' const window = new CursorWindow() // Inject AI responses await window.injectCode({ position: cursorPosition, code: mcpResponse.code, animate: true // Smooth typing animation }) // Handle user interactions window.onCommand('refactor', async (selection) => { const mcpMessage = await bridge.createRefactorRequest(selection) const response = await mcpServer.send(mcpMessage) await window.applyRefactoring(response) })

3. Gestión del contexto :

   import { ContextManager } from 'cursor-mcp/context' const context = new ContextManager() // Track file dependencies await context.addFile('component.tsx') await context.trackDependencies() // Maintain conversation history context.addMessage({ role: 'user', content: 'Refactor this component' }) // Send to MCP server const response = await mcpServer.send({ type: 'refactor', context: context.getFullContext() })

Seguridad

• Autenticación segura basada en tokens para servicios de IA

• Canales de comunicación cifrados

• Entorno de ejecución en espacio aislado

• Controles de permisos de grano fino

Requisitos

Ventanas

• Windows 10 o posterior

• Node.js 18 o posterior

• Privilegios de administrador para la instalación

macOS

• macOS 10.15 (Catalina) o posterior

• Node.js 18 o posterior

• Herramientas de línea de comandos de Xcode

• Permisos de accesibilidad para la Terminal

Linux

• Servidor de visualización X11

• Node.js 18 o posterior

• herramienta xdotool

• libxtst-dev

• libpng++-dev

• construcción esencial

Desarrollo

Configuración

Ejecución de pruebas

Contribuyendo

¡Agradecemos sus contribuciones! Consulte nuestra Guía de Contribución para más detalles.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Apoyo

• 📚 Documentación

• 🐛 Rastreador de problemas

• 💬 Discusiones

• 🔒 Seguridad

Expresiones de gratitud

• Editor de cursores : el editor de código basado en IA

• Claude AI - Asistente avanzado de IA

• @nut-tree/nut-js - Automatización multiplataforma

• active-win - Detección de ventanas