⚡ Inicio Rápido: ¡Construye un servidor MCP listo para producción que automatiza la clonación de repositorios GitHub y la integración con VS Code en solo 30 minutos!
Al finalizar este laboratorio, podrás:
- ✅ Crear un servidor MCP personalizado para flujos de trabajo de desarrollo reales
- ✅ Implementar la funcionalidad de clonación de repositorios GitHub vía MCP
- ✅ Integrar servidores MCP personalizados con VS Code y Agent Builder
- ✅ Usar GitHub Copilot Agent Mode con herramientas MCP personalizadas
- ✅ Probar y desplegar servidores MCP personalizados en entornos productivos
- Haber completado los laboratorios 1-3 (fundamentos y desarrollo avanzado de MCP)
- Suscripción a GitHub Copilot (registro gratuito disponible)
- VS Code con las extensiones AI Toolkit y GitHub Copilot instaladas
- CLI de Git instalado y configurado
Como desarrolladores, frecuentemente usamos GitHub para clonar repositorios y abrirlos en VS Code o VS Code Insiders. Este proceso manual implica:
- Abrir terminal o consola
- Navegar al directorio deseado
- Ejecutar el comando
git clone - Abrir VS Code en el directorio clonado
¡Nuestra solución MCP simplifica todo esto en un solo comando inteligente!
Un Servidor MCP de Clonación GitHub (git_mcp_server) que ofrece:
| Característica | Descripción | Beneficio |
|---|---|---|
| 🔄 Clonación Inteligente de Repositorios | Clona repositorios GitHub con validación | Verificación automática de errores |
| 📁 Gestión Inteligente de Directorios | Verifica y crea directorios de forma segura | Evita sobrescritura accidental |
| 🚀 Integración Multiplataforma con VS Code | Abre proyectos en VS Code/Insiders | Transición fluida en el flujo de trabajo |
| 🛡️ Manejo Robusto de Errores | Gestiona problemas de red, permisos y rutas | Fiabilidad lista para producción |
-
Abre Agent Builder desde la extensión AI Toolkit
-
Crea un nuevo agente con la siguiente configuración:
Agent Name: GitHubAgent -
Inicializa el servidor MCP personalizado:
- Ve a Tools → Add Tool → MCP Server
- Selecciona "Create A new MCP Server"
- Escoge la plantilla Python para máxima flexibilidad
- Nombre del servidor:
git_mcp_server
- Abre GitHub Copilot en VS Code (Ctrl/Cmd + Shift + P → "GitHub Copilot: Open")
- Selecciona el modelo Agent en la interfaz de Copilot
- Elige el modelo Claude 3.7 para capacidades avanzadas de razonamiento
- Activa la integración MCP para acceso a herramientas
💡 Consejo Profesional: Claude 3.7 ofrece una comprensión superior de flujos de trabajo de desarrollo y patrones de manejo de errores.
Usa el siguiente prompt detallado con GitHub Copilot Agent Mode:
Create two MCP tools with the following comprehensive requirements:
🔧 TOOL A: clone_repository
Requirements:
- Clone any GitHub repository to a specified local folder
- Return the absolute path of the successfully cloned project
- Implement comprehensive validation:
✓ Check if target directory already exists (return error if exists)
✓ Validate GitHub URL format (https://github.com/user/repo)
✓ Verify git command availability (prompt installation if missing)
✓ Handle network connectivity issues
✓ Provide clear error messages for all failure scenarios
🚀 TOOL B: open_in_vscode
Requirements:
- Open specified folder in VS Code or VS Code Insiders
- Cross-platform compatibility (Windows/Linux/macOS)
- Use direct application launch (not terminal commands)
- Auto-detect available VS Code installations
- Handle cases where VS Code is not installed
- Provide user-friendly error messages
Additional Requirements:
- Follow MCP 1.9.3 best practices
- Include proper type hints and documentation
- Implement logging for debugging purposes
- Add input validation for all parameters
- Include comprehensive error handling
- Inicia la configuración de depuración en Agent Builder
- Configura tu agente con este prompt del sistema:
SYSTEM_PROMPT:
You are my intelligent coding repository assistant. You help developers efficiently clone GitHub repositories and set up their development environment. Always provide clear feedback about operations and handle errors gracefully.
- Prueba con escenarios realistas de usuario:
USER_PROMPT EXAMPLES:
Scenario : Basic Clone and Open
"Clone {Your GitHub Repo link such as https://github.com/kinfey/GHCAgentWorkshop
} and save to {The global path you specify}, then open it with VS Code Insiders"
Resultados Esperados:
- ✅ Clonación exitosa con confirmación de ruta
- ✅ Lanzamiento automático de VS Code
- ✅ Mensajes claros de error en escenarios inválidos
- ✅ Manejo adecuado de casos límite
🎉 ¡Felicidades! Has creado exitosamente un servidor MCP práctico y listo para producción que resuelve desafíos reales en flujos de trabajo de desarrollo. Tu servidor personalizado de clonación GitHub demuestra el poder de MCP para automatizar y mejorar la productividad de desarrolladores.
- ✅ Desarrollador MCP - Creaste un servidor MCP personalizado
- ✅ Automatizador de Flujos - Simplificaste procesos de desarrollo
- ✅ Experto en Integración - Conectaste múltiples herramientas de desarrollo
- ✅ Listo para Producción - Construiste soluciones desplegables
Estimado Participante del Taller,
¡Felicitaciones por completar los cuatro módulos del taller Model Context Protocol! Has avanzado desde comprender conceptos básicos del AI Toolkit hasta construir servidores MCP listos para producción que solucionan desafíos reales de desarrollo.
Módulo 1: Comenzaste explorando fundamentos del AI Toolkit, pruebas de modelos y creación de tu primer agente AI.
Módulo 2: Aprendiste la arquitectura MCP, integraste Playwright MCP y creaste tu primer agente de automatización de navegador.
Módulo 3: Avanzaste en desarrollo de servidores MCP personalizados con el servidor Weather MCP y dominaste herramientas de depuración.
Módulo 4: Ahora aplicaste todo para crear una herramienta práctica de automatización de flujo de trabajo de repositorios GitHub.
- ✅ Ecosistema AI Toolkit: Modelos, agentes y patrones de integración
- ✅ Arquitectura MCP: Diseño cliente-servidor, protocolos de transporte y seguridad
- ✅ Herramientas para Desarrolladores: Desde Playground hasta Inspector y despliegue en producción
- ✅ Desarrollo Personalizado: Construcción, prueba y despliegue de servidores MCP propios
- ✅ Aplicaciones Prácticas: Resolución de desafíos reales con IA
- Construye tu propio servidor MCP: Aplica estas habilidades para automatizar tus flujos de trabajo únicos
- Únete a la comunidad MCP: Comparte tus creaciones y aprende de otros
- Explora integraciones avanzadas: Conecta servidores MCP con sistemas empresariales
- Contribuye a código abierto: Ayuda a mejorar las herramientas y documentación MCP
Recuerda, este taller es solo el comienzo. El ecosistema Model Context Protocol está evolucionando rápidamente, y ahora estás preparado para estar a la vanguardia en herramientas de desarrollo impulsadas por IA.
Gracias por tu participación y dedicación al aprendizaje!
Esperamos que este taller haya inspirado ideas que transformarán cómo construyes e interactúas con herramientas AI en tu camino de desarrollo.
¡Feliz codificación!
Prohlášení o vyloučení odpovědnosti:
Tento dokument byl přeložen pomocí AI překladatelské služby Co-op Translator. I když usilujeme o přesnost, mějte prosím na paměti, že automatizované překlady mohou obsahovat chyby nebo nepřesnosti. Původní dokument v jeho mateřském jazyce by měl být považován za autoritativní zdroj. Pro důležité informace se doporučuje profesionální lidský překlad. Nejsme odpovědní za jakékoli nedorozumění nebo nesprávné výklady vyplývající z použití tohoto překladu.