wehub-resource-sync
227 lines
11 KiB
Markdown
227 lines
11 KiB
Markdown
# Optimización de Flujos de Trabajo con IA: Construyendo un Servidor MCP con Microsoft Foundry Toolkit
|
|
|
|
[](https://spec.modelcontextprotocol.io/specification/2025-11-25/)
|
|
[](https://python.org)
|
|
[](https://code.visualstudio.com/)
|
|
|
|
|
|
|
|
## 🎯 Resumen
|
|
|
|
[](https://youtu.be/r34Csn3rkeQ)
|
|
|
|
_(Haz clic en la imagen de arriba para ver el video de esta lección)_
|
|
|
|
¡Bienvenido al **Taller de Model Context Protocol (MCP)**! Este taller práctico y completo combina dos tecnologías punteras para revolucionar el desarrollo de aplicaciones de IA:
|
|
|
|
- **🔗 Model Context Protocol (MCP)**: Un estándar abierto para la integración fluida con herramientas de IA
|
|
- **🛠️ Microsoft Foundry Toolkit Extension para VS Code**: La potente extensión de desarrollo IA de Microsoft
|
|
|
|
### 🎓 Qué Aprenderás
|
|
|
|
Al finalizar este taller, dominarás el arte de construir aplicaciones inteligentes que conectan modelos de IA con herramientas y servicios del mundo real. Desde pruebas automatizadas hasta integraciones API personalizadas, adquirirás habilidades prácticas para resolver desafíos empresariales complejos.
|
|
|
|
## 🏗️ Tecnología Usada
|
|
|
|
### 🔌 Model Context Protocol (MCP)
|
|
|
|
MCP es el **"USB-C para IA"**: un estándar universal que conecta modelos de IA con herramientas y fuentes de datos externas.
|
|
|
|
**✨ Características Clave:**
|
|
|
|
- 🔄 **Integración Estandarizada**: Interfaz universal para conexiones con herramientas IA
|
|
- 🏛️ **Arquitectura Flexible**: Servidores locales y remotos mediante transporte stdio/SSE
|
|
- 🧰 **Ecosistema Rico**: Herramientas, prompts y recursos en un solo protocolo
|
|
- 🔒 **Listo para Empresas**: Seguridad y fiabilidad integradas
|
|
|
|
**🎯 Importancia de MCP:**
|
|
Al igual que USB-C eliminó el caos de cables, MCP elimina la complejidad de las integraciones IA. Un protocolo, infinitas posibilidades.
|
|
|
|
### 🤖 Microsoft Foundry Toolkit Extension para VS Code
|
|
|
|
La extensión insignia de Microsoft para desarrollo IA que convierte VS Code en una potencia IA.
|
|
|
|
**🚀 Capacidades Principales:**
|
|
|
|
- 📦 **Catálogo de Modelos**: Acceso a modelos de Azure AI, GitHub, Hugging Face, Ollama
|
|
- ⚡ **Inferencia Local**: Ejecución optimizada ONNX en CPU/GPU/NPU
|
|
- 🏗️ **Constructor de Agentes**: Desarrollo visual de agentes IA con integración MCP
|
|
- 🎭 **Multi-Modal**: Soporte para texto, visión y salidas estructuradas
|
|
|
|
**💡 Beneficios para Desarrollo:**
|
|
|
|
- Despliegue de modelos sin configuración
|
|
- Ingeniería visual de prompts
|
|
- Zona de pruebas en tiempo real
|
|
- Integración fluida con servidores MCP
|
|
|
|
## 📚 Trayectoria de Aprendizaje
|
|
|
|
### [🚀 Módulo 1: Fundamentos de Microsoft Foundry Toolkit](./lab1/README.md)
|
|
|
|
**Duración**: 15 minutos
|
|
|
|
- 🛠️ Instala y configura Microsoft Foundry Toolkit para VS Code
|
|
- 🗂️ Explora el Catálogo de Modelos (más de 100 modelos de GitHub, ONNX, OpenAI, Anthropic, Google)
|
|
- 🎮 Domina el Playground Interactivo para pruebas en tiempo real
|
|
- 🤖 Construye tu primer agente IA con Agent Builder
|
|
- 📊 Evalúa rendimiento de modelos con métricas integradas (F1, relevancia, similitud, coherencia)
|
|
- ⚡ Aprende procesamiento por lotes y capacidades multimodales
|
|
|
|
**🎯 Resultado de Aprendizaje**: Crear un agente IA funcional con comprensión integral de las capacidades de Microsoft Foundry Toolkit
|
|
|
|
### [🌐 Módulo 2: MCP con Microsoft Foundry Toolkit Fundamentos](./lab2/README.md)
|
|
|
|
**Duración**: 20 minutos
|
|
|
|
- 🧠 Domina arquitectura y conceptos de Model Context Protocol (MCP)
|
|
- 🌐 Explora el ecosistema de servidores MCP de Microsoft
|
|
- 🤖 Construye un agente de automatización web usando Playwright MCP server
|
|
- 🔧 Integra servidores MCP con Microsoft Foundry Toolkit Agent Builder
|
|
- 📊 Configura y prueba herramientas MCP dentro de tus agentes
|
|
- 🚀 Exporta y despliega agentes potenciados con MCP para producción
|
|
|
|
**🎯 Resultado de Aprendizaje**: Desplegar un agente IA supercargado con herramientas externas mediante MCP
|
|
|
|
### [🔧 Módulo 3: Desarrollo Avanzado MCP con Microsoft Foundry Toolkit](./lab3/README.md)
|
|
|
|
**Duración**: 20 minutos
|
|
|
|
- 💻 Crea servidores MCP personalizados usando Microsoft Foundry Toolkit
|
|
- 🐍 Configura y utiliza el último SDK MCP Python (v1.9.3)
|
|
- 🔍 Configura y utiliza MCP Inspector para depuración
|
|
- 🛠️ Construye un Servidor MCP de Clima con flujos profesionales de depuración
|
|
- 🧪 Depura servidores MCP tanto en Agent Builder como en Inspector
|
|
|
|
**🎯 Resultado de Aprendizaje**: Desarrollar y depurar servidores MCP personalizados con herramientas modernas
|
|
|
|
### [🐙 Módulo 4: Desarrollo Práctico MCP - Servidor Clon GitHub Personalizado](./lab4/README.md)
|
|
|
|
**Duración**: 30 minutos
|
|
|
|
- 🏗️ Construye un servidor MCP Clon GitHub real para flujos de desarrollo
|
|
- 🔄 Implementa clonado inteligente de repositorios con validación y manejo de errores
|
|
- 📁 Crea gestión inteligente de directorios e integración con VS Code
|
|
- 🤖 Usa GitHub Copilot Agent Mode con herramientas MCP personalizadas
|
|
- 🛡️ Aplica fiabilidad lista para producción y compatibilidad multiplataforma
|
|
|
|
**🎯 Resultado de Aprendizaje**: Desplegar un servidor MCP listo para producción que optimiza flujos de desarrollo reales
|
|
|
|
## 💡 Aplicaciones Reales e Impacto
|
|
|
|
### 🏢 Casos de Uso Empresariales
|
|
|
|
#### 🔄 Automatización DevOps
|
|
|
|
Transforma tu flujo de desarrollo con automatización inteligente:
|
|
|
|
- **Gestión Inteligente de Repositorios**: Revisión de código y decisiones de merge impulsadas por IA
|
|
- **CI/CD Inteligente**: Optimización automática de pipelines basada en cambios de código
|
|
- **Priorización de Incidencias**: Clasificación y asignación automática de bugs
|
|
|
|
#### 🧪 Revolución en Aseguramiento de Calidad
|
|
|
|
Eleva las pruebas con automatización potenciada por IA:
|
|
|
|
- **Generación Inteligente de Pruebas**: Creación automática de suites de prueba completas
|
|
- **Pruebas de Regresión Visual**: Detección IA de cambios en UI
|
|
- **Monitoreo de Rendimiento**: Identificación y resolución proactiva de problemas
|
|
|
|
#### 📊 Inteligencia en Pipelines de Datos
|
|
|
|
Construye flujos de procesamiento de datos más inteligentes:
|
|
|
|
- **Procesos ETL Adaptativos**: Transformaciones de datos auto-optimizadas
|
|
- **Detección de Anomalías**: Monitoreo de calidad de datos en tiempo real
|
|
- **Enrutamiento Inteligente**: Gestión inteligente del flujo de datos
|
|
|
|
#### 🎧 Mejora de la Experiencia del Cliente
|
|
|
|
Crea interacciones excepcionales con los clientes:
|
|
|
|
- **Soporte Contextual**: Agentes IA con acceso al historial del cliente
|
|
- **Resolución Proactiva de Problemas**: Servicio predictivo al cliente
|
|
- **Integración Multi-Canal**: Experiencia IA unificada en múltiples plataformas
|
|
|
|
## 🛠️ Requisitos y Configuración
|
|
|
|
### 💻 Requisitos del Sistema
|
|
|
|
| Componente | Requisito | Notas |
|
|
|-----------|-------------|-------|
|
|
| **Sistema Operativo** | Windows 10+, macOS 10.15+, Linux | Cualquier sistema operativo moderno |
|
|
| **Visual Studio Code** | Última versión estable | Requerido para Microsoft Foundry Toolkit |
|
|
| **Node.js** | v18.0+ y npm | Para desarrollo de servidor MCP |
|
|
| **Python** | 3.10+ | Opcional para servidores MCP en Python |
|
|
| **Memoria** | 8GB RAM mínimo | 16GB recomendado para modelos locales |
|
|
|
|
### 🔧 Entorno de Desarrollo
|
|
|
|
#### Extensiones VS Code Recomendadas
|
|
|
|
- **Microsoft Foundry Toolkit** (ms-windows-ai-studio.windows-ai-studio)
|
|
- **Python** (ms-python.python)
|
|
- **Depurador Python** (ms-python.debugpy)
|
|
- **GitHub Copilot** (GitHub.copilot) - Opcional pero útil
|
|
|
|
#### Herramientas Opcionales
|
|
|
|
- **uv**: Gestor moderno de paquetes Python
|
|
- **MCP Inspector**: Herramienta visual de depuración para servidores MCP
|
|
- **Playwright**: Para ejemplos de automatización web
|
|
|
|
## 🎖️ Resultados del Aprendizaje y Ruta de Certificación
|
|
|
|
### 🏆 Lista de Dominio de Habilidades
|
|
|
|
Al completar este taller, lograrás dominio en:
|
|
|
|
#### 🎯 Competencias Clave
|
|
|
|
- [ ] **Dominio del Protocolo MCP**: Comprensión profunda de arquitectura y patrones de implementación
|
|
- [ ] **Competencia en Microsoft Foundry Toolkit**: Uso experto para desarrollo rápido
|
|
- [ ] **Desarrollo de Servidores Personalizados**: Construir, desplegar y mantener servidores MCP en producción
|
|
- [ ] **Excelencia en Integración de Herramientas**: Conexión fluida de IA con flujos de trabajo existentes
|
|
- [ ] **Aplicación en Resolución de Problemas**: Aplicar habilidades para retos empresariales reales
|
|
|
|
#### 🔧 Habilidades Técnicas
|
|
|
|
- [ ] Configurar y usar Microsoft Foundry Toolkit en VS Code
|
|
- [ ] Diseñar e implementar servidores MCP personalizados
|
|
- [ ] Integrar Modelos GitHub con arquitectura MCP
|
|
- [ ] Construir flujos de pruebas automatizadas con Playwright
|
|
- [ ] Desplegar agentes IA para producción
|
|
- [ ] Depurar y optimizar desempeño de servidores MCP
|
|
|
|
#### 🚀 Capacidades Avanzadas
|
|
|
|
- [ ] Arquitecturar integraciones IA a escala empresarial
|
|
- [ ] Implementar mejores prácticas de seguridad para aplicaciones IA
|
|
- [ ] Diseñar arquitecturas escalables de servidores MCP
|
|
- [ ] Crear cadenas de herramientas personalizadas para dominios específicos
|
|
- [ ] Mentorizar a otros en desarrollo nativo IA
|
|
|
|
## 📖 Recursos Adicionales
|
|
|
|
- [Especificación MCP (2025-11-25)](https://spec.modelcontextprotocol.io/specification/2025-11-25/)
|
|
- [Repositorio Microsoft Foundry Toolkit en GitHub](https://github.com/microsoft/vscode-ai-toolkit)
|
|
- [Colección de Servidores MCP de Ejemplo](https://github.com/modelcontextprotocol/servers)
|
|
- [Guía de Mejores Prácticas](https://modelcontextprotocol.io/docs/best-practices)
|
|
- [OWASP MCP Top 10](https://microsoft.github.io/mcp-azure-security-guide/mcp/) - Mejores prácticas de seguridad
|
|
|
|
---
|
|
|
|
**🚀 ¿Listo para revolucionar tu flujo de desarrollo IA?**
|
|
|
|
Construyamos juntos el futuro de las aplicaciones inteligentes con MCP y Microsoft Foundry Toolkit!
|
|
|
|
## Qué Sigue
|
|
|
|
Continúa con: [Módulo 11: Laboratorios Prácticos de Servidor MCP](../11-MCPServerHandsOnLabs/README.md)
|
|
|
|
---
|
|
|
|
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
|
|
**Descargo de responsabilidad**:
|
|
Este documento ha sido traducido utilizando el servicio de traducción automática [Co-op Translator](https://github.com/Azure/co-op-translator). Aunque nos esforzamos por la precisión, tenga en cuenta que las traducciones automatizadas pueden contener errores o inexactitudes. El documento original en su idioma nativo debe considerarse la fuente autorizada. Para información crítica, se recomienda una traducción profesional humana. No somos responsables de cualquier malentendido o interpretación errónea que surja del uso de esta traducción.
|
|
<!-- CO-OP TRANSLATOR DISCLAIMER END --> |