AI Development Assistant MCP Server

🤖 AI Development Assistant MCP Server

Bienvenido a tu kit de herramientas de desarrollo impulsado por IA, diseñado como un servidor Model Context Protocol (MCP) para Cursor! Este proyecto proporciona asistencia inteligente de codificación a través de herramientas de IA personalizadas. Ten en cuenta que esto es principalmente una demo de tutorial, y no una herramienta lista para producción.

✨ Características

🎨 Code Architect

Llama a LLMs de razonamiento avanzado para generar planes e instrucciones para agentes de codificación.

📸 Screenshot Buddy

Toma capturas de pantalla de diseño de UI y úsalas con el agente compositor.

🔍 Code Review

Usa diffs de git para desencadenar revisiones de código.

📄 Read file & Read multiple files

La lectura de un solo archivo permite un análisis eficiente de datos; la lectura de múltiples archivos facilita el procesamiento por lotes de datos.

🚀 Comenzando

1. Configuración del Entorno

Primero, necesitarás configurar tus variables de entorno. Crea un archivo en src/env/keys.ts:

export const OPENAI_API_KEY = "your_key_here";
// Add any other keys you need

⚠️ Nota de seguridad: No se recomienda almacenar claves de API directamente en el código fuente para entornos de producción. Esto es solo para desarrollo local y fines de aprendizaje. También puedes configurar la variable de entorno en línea en la interfaz MCP de Cursor.

2. Instalación

npm install
# or
yarn install

3. Compilar el Servidor

npm run build

4. Abrir Windsurf Chat y Configurar MCP

Este proyecto está diseñado para usarse como un servidor MCP en Cursor. Así es como configurarlo:

1. Abre Windsurf en tu sistema.
2. Navega a la sección de Chat.
3. Haz clic en + Configure MCP (esto te permite agregar un nuevo servidor MCP).
4. Agrega la siguiente configuración JSON:

{
  "mcpServers": {
    "mcp-server": {
      "command": "node",
      "args": [
        "D:\\mpc-server\\build\\index.js"
      ]
    }
  }
}

📘 Consejo profesional: Es posible que necesites usar la ruta completa al archivo index.js compilado de tu proyecto.

Después de agregar el servidor, deberías ver tus herramientas listadas en "Herramientas disponibles". Si no, intenta hacer clic en el botón de actualizar en la esquina superior derecha de la sección del servidor MCP.

Para más detalles sobre la configuración de MCP, consulta la Documentación de MCP de Windsurf.

🛠️ Usando las Herramientas

Una vez configurado, puedes usar estas herramientas directamente en el Composer de Cursor. La IA sugerirá automáticamente usar herramientas relevantes, o puedes solicitarlas explícitamente por nombre o descripción.

Por ejemplo, intenta escribir en Composer:

• "Revisa este código para mejores prácticas"
• "Ayúdame a diseñar una nueva funcionalidad"
• "Analiza esta captura de pantalla de UI"
• "Read single file & Read multiple files"

El agente pedirá tu aprobación antes de realizar cualquier llamada a herramientas.

📘 Consejo profesional: Puedes actualizar tu archivo .cursorrules con instrucciones sobre cómo usar las herramientas para ciertos escenarios, y el agente usará las herramientas automáticamente.

📁 Estructura del Proyecto

src/
├── tools/
│   ├── architect.ts    # Code structure generator
│   ├── screenshot.ts   # Screenshot analysis tool
│   ├── fileReader.ts  # read file & read multiple files tool
│   └── codeReview.ts   # Code review tool
├── env/
│   └── keys.ts         # Environment configuration (add your API keys here!)
└── index.ts           # Main entry point

---