Skip to content

Latest commit

 

History

History
264 lines (193 loc) · 19.8 KB

File metadata and controls

264 lines (193 loc) · 19.8 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

Sigue estos pasos para comenzar a usar estos recursos:

  1. Haz un Fork del Repositorio: Haz clic en GitHub forks
  2. Clona el Repositorio: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Únete al Discord de Azure AI Foundry y conoce a expertos y otros desarrolladores

🌐 Soporte Multilingüe

Soportado mediante GitHub Action (Automatizado y Siempre Actualizado)

Francés | Español | Alemán | Ruso | Árabe | Persa (Farsi) | Urdu | Chino (Simplificado) | Chino (Tradicional, Macao) | Chino (Tradicional, Hong Kong) | Chino (Tradicional, Taiwán) | Japonés | Coreano | Hindi | Bengalí | Maratí | Nepalí | Punjabi (Gurmukhi) | Portugués (Portugal) | Portugués (Brasil) | Italiano | Polaco | Turco | Griego | Tailandés | Sueco | Danés | Noruego | Finlandés | Neerlandés | Hebreo | Vietnamita | Indonesio | Malayo | Tagalo (Filipino) | Swahili | Húngaro | Checo | Eslovaco | Rumano | Búlgaro | Serbio (Cirílico) | Croata | Esloveno | Ucraniano | Birmano (Myanmar)

🚀 Currículo del Protocolo de Contexto de Modelo (MCP) para Principiantes

Aprende MCP con ejemplos prácticos en C#, Java, JavaScript, Python y TypeScript

🧠 Resumen del Currículo del Protocolo de Contexto de Modelo

El Protocolo de Contexto de Modelo (MCP) es un marco innovador diseñado para estandarizar las interacciones entre modelos de IA y aplicaciones cliente. Este currículo de código abierto ofrece una ruta de aprendizaje estructurada, con ejemplos prácticos de código y casos de uso reales, en lenguajes de programación populares como C#, Java, JavaScript, TypeScript y Python.

Ya seas desarrollador de IA, arquitecto de sistemas o ingeniero de software, esta guía es tu recurso completo para dominar los fundamentos y las estrategias de implementación de MCP.

🔗 Recursos Oficiales de MCP

Únete a MCP Dev Days 29-30 de julio de 2025

Prepárate para dos días de profundo conocimiento técnico, conexión con la comunidad y aprendizaje práctico en MCP Dev Days, un evento virtual dedicado al Protocolo de Contexto de Modelo (MCP), el estándar emergente que conecta modelos de IA con las herramientas que utilizan.

➡️ Regístrate en MCP Dev Days

Puedes ver MCP Dev Days registrándote en nuestra página del evento: https://aka.ms/mcpdevdays. Desde ahí, podrás unirte a una transmisión en vivo en YouTube o Twitch. Todo el contenido queda grabado y estará disponible después en el canal de Microsoft Developer en YouTube. El código fuente de las demos también estará disponible en GitHub.

Detalles del Evento

  • Fechas: 29 de julio (Día 1) y 30 de julio (Día 2)
  • Hora: 9:00 AM PST cada día
  • Lugar: En línea – ¡participa desde cualquier lugar!

Día 1: Productividad MCP, DevTools y Comunidad

Se centra en empoderar a los desarrolladores para usar MCP en su flujo de trabajo y celebrar la increíble comunidad MCP. Contaremos con miembros de la comunidad y socios como Arcade, Block, Okta y Neon para mostrar cómo colaboran con Microsoft para crear un ecosistema MCP abierto y extensible. Demos reales en VS Code, Visual Studio, GitHub Copilot y herramientas populares de la comunidad
Flujos de trabajo prácticos y orientados al contexto
Sesiones e ideas lideradas por la comunidad
Ya sea que estés comenzando con MCP o ya estés desarrollando con él, el Día 1 te inspirará y te dejará aprendizajes prácticos.

Día 2: Construye Servidores MCP con Confianza

Dirigido a constructores MCP. Profundizaremos en estrategias de implementación y mejores prácticas para crear servidores MCP e integrar MCP en tus flujos de trabajo de IA.

Temas incluyen:

  • Construcción de servidores MCP e integración en experiencias de agentes
  • Desarrollo basado en prompts
  • Mejores prácticas de seguridad
  • Uso de bloques constructores como Functions, ACA y API Management
  • Alineación de registros y herramientas (1P + 3P)

Si eres desarrollador, creador de herramientas o estratega de productos de IA, este día está lleno de conocimientos para construir soluciones MCP escalables, seguras y preparadas para el futuro.

🧭 Resumen del Currículo MCP

📚 Estructura Completa del Currículo

Módulo Tema Descripción Enlace
Módulos 1-3: Fundamentos
00 Introducción a MCP Visión general del Protocolo de Contexto de Modelo y su importancia en pipelines de IA Leer más
01 Conceptos Básicos Explicados Exploración profunda de los conceptos centrales de MCP Leer más
02 Seguridad en MCP Amenazas de seguridad y mejores prácticas Leer más
03 Primeros Pasos con MCP Configuración del entorno, servidores/clientes básicos, integración Leer más
Módulo 3: Construyendo tu Primer Servidor y Cliente
3.1 Primer Servidor Crea tu primer servidor MCP Guía
3.2 Primer Cliente Desarrolla un cliente MCP básico Guía
3.3 Cliente con LLM Integra modelos de lenguaje grandes Guía
3.4 Integración con VS Code Consume servidores MCP en VS Code Guía
3.5 Servidor SSE Crea servidores usando Server-Sent Events Guía
3.6 Streaming HTTP Implementa streaming HTTP en MCP Guía
3.7 AI Toolkit Usa AI Toolkit con MCP Guía
3.8 Pruebas Prueba tu implementación de servidor MCP Guía
3.9 Despliegue Despliega servidores MCP en producción Guía
Módulos 4-5: Práctico y Avanzado
04 Implementación Práctica SDKs, depuración, pruebas, plantillas reutilizables de prompts Leer más
05 Temas Avanzados en MCP IA multimodal, escalabilidad, uso empresarial Leer más
5.1 Integración con Azure Integración MCP con Azure Guía
5.2 Multimodalidad Trabajando con múltiples modalidades Guía
5.3 Demo OAuth2 Implementa autenticación OAuth2 Guía
5.4 Contextos Raíz Entiende e implementa contextos raíz Guía
5.5 Enrutamiento Estrategias de enrutamiento MCP Guía
5.6 Muestreo Técnicas de muestreo en MCP Guía
5.7 Escalabilidad Escala implementaciones MCP Guía
5.8 Seguridad Consideraciones avanzadas de seguridad Guía
5.9 Búsqueda Web Implementa capacidades de búsqueda web Guía
5.10 Streaming en Tiempo Real Construye funcionalidad de streaming en tiempo real Guía
5.11 Búsqueda en Tiempo Real Implementa búsqueda en tiempo real Guía
5.12 Autenticación Entra ID Autenticación con Microsoft Entra ID Guía
5.13 Integración Foundry Integración con Azure AI Foundry Guía
5.14 Ingeniería de Contexto Técnicas para una ingeniería de contexto efectiva Guía
Módulo 6-10: Comunidad y Mejores Prácticas
06 Contribuciones de la Comunidad Cómo contribuir al ecosistema MCP Guía
07 Lecciones de la Adopción Temprana Historias de implementación en el mundo real Guía
08 Mejores Prácticas para MCP Rendimiento, tolerancia a fallos, resiliencia Guía
09 Estudios de Caso MCP Ejemplos prácticos de implementación Guía
10 Taller Práctico Construyendo un Servidor MCP con AI Toolkit Laboratorio

💻 Proyectos de Código de Ejemplo

Ejemplos Básicos de Calculadora MCP

Lenguaje Descripción Enlace
C# Ejemplo de Servidor MCP Ver Código
Java Calculadora MCP Ver Código
JavaScript Demo MCP Ver Código
Python Servidor MCP Ver Código
TypeScript Ejemplo MCP Ver Código

Implementaciones Avanzadas de MCP

Lenguaje Descripción Enlace
C# Ejemplo Avanzado Ver Código
Java Ejemplo de Aplicación en Contenedor Ver Código
JavaScript Ejemplo Avanzado Ver Código
Python Implementación Compleja Ver Código
TypeScript Ejemplo en Contenedor Ver Código

🎯 Requisitos Previos para Aprender MCP

Para aprovechar al máximo este plan de estudios, deberías tener:

  • Conocimientos básicos de programación en al menos uno de los siguientes lenguajes: C#, Java, JavaScript, Python o TypeScript

  • Comprensión del modelo cliente-servidor y APIs

  • Familiaridad con conceptos REST y HTTP

  • (Opcional) Conocimientos básicos en conceptos de IA/ML

  • Participar en nuestras discusiones comunitarias para obtener soporte

📚 Guía de Estudio y Recursos

Este repositorio incluye varios recursos para ayudarte a navegar y aprender de forma efectiva:

Guía de Estudio

Hay disponible una Guía de Estudio completa para ayudarte a navegar este repositorio de manera eficiente. La guía incluye:

  • Un mapa visual del plan de estudios con todos los temas cubiertos
  • Desglose detallado de cada sección del repositorio
  • Orientación sobre cómo usar los proyectos de ejemplo
  • Rutas de aprendizaje recomendadas para diferentes niveles de habilidad
  • Recursos adicionales para complementar tu aprendizaje

Registro de Cambios

Mantenemos un Registro de Cambios detallado que documenta todas las actualizaciones importantes en los materiales del plan de estudios, incluyendo:

  • Nuevos contenidos añadidos
  • Cambios estructurales
  • Mejoras de funcionalidades
  • Actualizaciones en la documentación

🛠️ Cómo Usar Este Plan de Estudios de Forma Efectiva

Cada lección en esta guía incluye:

  1. Explicaciones claras de los conceptos MCP
  2. Ejemplos de código en vivo en varios lenguajes
  3. Ejercicios para construir aplicaciones MCP reales
  4. Recursos adicionales para estudiantes avanzados

🌟 Agradecimientos a la Comunidad

Gracias al Microsoft Valued Professional Shivam Goyal por contribuir con importantes ejemplos de código.

📜 Información de Licencia

Este contenido está licenciado bajo la Licencia MIT. Para términos y condiciones, consulta el LICENSE.

🤝 Directrices para Contribuir

Este proyecto acepta contribuciones y sugerencias. La mayoría de las contribuciones requieren que aceptes un Acuerdo de Licencia de Contribuidor (CLA) declarando que tienes el derecho y efectivamente otorgas los derechos para usar tu contribución. Para más detalles, visita
https://cla.opensource.microsoft.com.

Cuando envíes un pull request, un bot de CLA determinará automáticamente si necesitas proporcionar un CLA y marcará el PR apropiadamente (por ejemplo, verificación de estado, comentario). Solo sigue las instrucciones del bot. Solo tendrás que hacer esto una vez para todos los repositorios que usan nuestro CLA.

Este proyecto ha adoptado el Código de Conducta de Código Abierto de Microsoft. Para más información, consulta las Preguntas Frecuentes del Código de Conducta o contacta a opencode@microsoft.com para cualquier pregunta o comentario adicional.

📂 Estructura del Repositorio

El repositorio está organizado de la siguiente manera:

  • Currículo Principal (00-10): Contenido principal organizado en diez módulos secuenciales
  • images/: Diagramas e ilustraciones usados a lo largo del currículo
  • translations/: Soporte multilingüe con traducciones automáticas
  • translated_images/: Versiones localizadas de diagramas e ilustraciones
  • study_guide.md: Guía completa para navegar el repositorio
  • changelog.md: Registro de todos los cambios importantes en los materiales del currículo
  • mcp.json: Archivo de configuración para la especificación MCP
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Documentos de gobernanza del proyecto

🎒 Otros Cursos

¡Nuestro equipo produce otros cursos! Echa un vistazo a:

™️ Aviso de Marca Registrada

Este proyecto puede contener marcas registradas o logotipos de proyectos, productos o servicios. El uso autorizado de marcas o logotipos de Microsoft está sujeto y debe seguir las
Directrices de Marca y Uso de Microsoft.
El uso de marcas o logotipos de Microsoft en versiones modificadas de este proyecto no debe causar confusión ni implicar patrocinio de Microsoft.
Cualquier uso de marcas o logotipos de terceros está sujeto a las políticas de esos terceros.

Aviso legal:
Este documento ha sido traducido utilizando el servicio de traducción automática Co-op Translator. Aunque nos esforzamos por la precisión, tenga en cuenta que las traducciones automáticas pueden contener errores o inexactitudes. El documento original en su idioma nativo debe considerarse la fuente autorizada. Para información crítica, se recomienda la traducción profesional realizada por humanos. No nos hacemos responsables de malentendidos o interpretaciones erróneas derivadas del uso de esta traducción.