Sigue estos pasos para comenzar a usar estos recursos:
- Haz un Fork del Repositorio: Haz clic en
- Clona el Repositorio:
git clone https://github.com/microsoft/mcp-for-beginners.git - Únete al Discord de Azure AI Foundry y conecta con expertos y otros desarrolladores
🌐 Soporte Multilingüe
Disponible a través de GitHub Action (Automatizado y siempre actualizado)
Árabe | Bengalí | Búlgaro | Birmano (Myanmar) | Chino (Simplificado) | Chino (Tradicional, Hong Kong) | Chino (Tradicional, Macao) | Chino (Tradicional, Taiwán) | Croata | Checo | Danés | Holandés | Finlandés | Francés | Alemán | Griego | Hebreo | Hindi | Húngaro | Indonesio | Italiano | Japonés | Coreano | Malayo | Maratí | Nepalí | Noruego | Persa (Farsi) | Polaco | Portugués (Brasil) | Portugués (Portugal) | Punyabí (Gurmukhi) | Rumano | Ruso | Serbio (Cirílico) | Eslovaco | Esloveno | Español | Swahili | Sueco | Tagalo (Filipino) | Tailandés | Turco | Ucraniano | Urdu | Vietnamita
🚀 Currículo del Protocolo de Contexto de Modelo (MCP) para Principiantes
Aprende MCP con ejemplos prácticos de código en C#, Java, JavaScript, Rust, 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 inteligencia artificial y aplicaciones cliente. Este currículo de código abierto ofrece un camino de aprendizaje estructurado, completo con ejemplos prácticos de programación y casos de uso reales, en lenguajes de programación populares como C#, Java, JavaScript, TypeScript y Python.
Ya seas un desarrollador de IA, arquitecto de sistemas o ingeniero de software, esta guía es tu recurso integral para dominar los fundamentos y estrategias de implementación de MCP.
🔗 Recursos Oficiales de MCP
- 📘 Documentación de MCP – Tutoriales detallados y guías de usuario
- 📜 Especificación de MCP – Arquitectura del protocolo y referencias técnicas
- 📜 Especificación original de MCP – Referencias técnicas antiguas (pueden contener detalles adicionales)
- 🧑💻 Repositorio de GitHub de MCP – SDKs de código abierto, herramientas y ejemplos de código
- 🌐 Comunidad MCP – Únete a las discusiones y contribuye a la comunidad
🧭 Resumen del Currículo de MCP
📚 Estructura Completa del Currículo
| Módulo | Tema | Descripción | Enlace |
|---|---|---|---|
| Módulo 1-3: Fundamentos | |||
| 00 | Introducción a MCP | Resumen del Protocolo de Contexto de Modelo y su importancia en los flujos de trabajo de IA | Leer más |
| 01 | Explicación de Conceptos Básicos | Exploración detallada de los conceptos fundamentales de MCP | Leer más |
| 02 | Seguridad en MCP | Amenazas de seguridad y mejores prácticas | Leer más |
| 03 | Comenzando 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 grande | Guía |
| 3.4 | Integración con VS Code | Consume servidores MCP en VS Code | Guía |
| 3.5 | Servidor stdio | Crea servidores usando transporte stdio | Guía |
| 3.6 | Streaming HTTP | Implementa streaming HTTP en MCP | Guía |
| 3.7 | Toolkit de IA | Usa el Toolkit de IA 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 |
| 3.10 | Uso avanzado de servidores | Usa servidores avanzados para características avanzadas y arquitectura mejorada | Guía |
| 3.11 | Autenticación simple | Un capítulo que muestra autenticación desde el principio y RBAC | Guía |
| Módulo 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 de MCP con Azure | Guía |
| 5.2 | Multimodalidad | Trabajo con múltiples modalidades | Guía |
| 5.3 | Demostración de OAuth2 | Implementa autenticación OAuth2 | Guía |
| 5.4 | Contextos Raíz | Comprende e implementa contextos raíz | Guía |
| 5.5 | Enrutamiento | Estrategias de enrutamiento en MCP | Guía |
| 5.6 | Muestreo | Técnicas de muestreo en MCP | Guía |
| 5.7 | Escalabilidad | Escala implementaciones de 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 con Entra ID | Autenticación con Microsoft Entra ID | Guía |
| 5.13 | Integración con Foundry | Integra con Azure AI Foundry | Guía |
| 5.14 | Ingeniería de Contexto | Técnicas para una ingeniería de contexto efectiva | Guía |
| 5.15 | Transporte Personalizado de MCP | Implementaciones de transporte personalizado | 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 de MCP | Ejemplos prácticos de implementación | Guía |
| 10 | Taller Práctico | Construyendo un Servidor MCP con Toolkit de IA | Laboratorio |
| Módulo 11: Laboratorio Práctico de Servidor MCP | |||
| 11 | Integración de Base de Datos en Servidor MCP | Ruta de aprendizaje práctica de 13 laboratorios para integración con PostgreSQL | Laboratorios |
| 11.1 | Introducción | Resumen de MCP con integración de base de datos y caso de uso de análisis de ventas minoristas | Laboratorio 00 |
| 11.2 | Arquitectura Central | Comprender la arquitectura del servidor MCP, capas de base de datos y patrones de seguridad | Lab 01 |
| 11.3 | Seguridad y Multitenencia | Seguridad a nivel de fila, autenticación y acceso a datos multi-tenant | Lab 02 |
| 11.4 | Configuración del Entorno | Configuración del entorno de desarrollo, Docker, recursos de Azure | Lab 03 |
| 11.5 | Diseño de Base de Datos | Configuración de PostgreSQL, diseño de esquema para retail y datos de ejemplo | Lab 04 |
| 11.6 | Implementación del Servidor MCP | Construcción del servidor FastMCP con integración de base de datos | Lab 05 |
| 11.7 | Desarrollo de Herramientas | Creación de herramientas de consulta de base de datos e introspección de esquemas | Lab 06 |
| 11.8 | Búsqueda Semántica | Implementación de embeddings vectoriales con Azure OpenAI y pgvector | Lab 07 |
| 11.9 | Pruebas y Depuración | Estrategias de prueba, herramientas de depuración y enfoques de validación | Lab 08 |
| 11.10 | Integración con VS Code | Configuración de la integración MCP en VS Code y uso de AI Chat | Lab 09 |
| 11.11 | Estrategias de Despliegue | Despliegue con Docker, Azure Container Apps y consideraciones de escalabilidad | Lab 10 |
| 11.12 | Monitoreo | Application Insights, registro de logs y monitoreo de rendimiento | Lab 11 |
| 11.13 | Mejores Prácticas | Optimización de rendimiento, fortalecimiento de seguridad y consejos para producción | Lab 12 |
💻 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 |
| Rust | Ejemplo MCP | Ver Código |
Implementaciones Avanzadas de MCP
| Lenguaje | Descripción | Enlace |
|---|---|---|
| C# | Ejemplo Avanzado | Ver Código |
| Java con Spring | Ejemplo de App en Contenedor | Ver Código |
| JavaScript | Ejemplo Avanzado | Ver Código |
| Python | Implementación Compleja | Ver Código |
| TypeScript | Ejemplo de Contenedor | Ver Código |
🎯 Requisitos Previos para Aprender MCP
Para aprovechar al máximo este currículo, 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 de REST y HTTP
(Opcional) Conocimientos en conceptos de IA/ML
Participar en nuestras discusiones comunitarias para obtener apoyo
📚 Guía de Estudio y Recursos
Este repositorio incluye varios recursos para ayudarte a aprender de manera efectiva:
Guía de Estudio
Una Guía de Estudio completa está disponible para ayudarte a navegar este repositorio. La guía incluye:
- Un mapa visual del currículo mostrando 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 rastrea todas las actualizaciones significativas de los materiales del currículo, incluyendo:
- Adiciones de contenido nuevo
- Cambios estructurales
- Mejoras de características
- Actualizaciones de documentación
🛠️ Cómo Usar Este Currículo de Forma Efectiva
Cada lección en esta guía incluye:
- Explicaciones claras de los conceptos MCP
- Ejemplos de código en vivo en múltiples lenguajes
- Ejercicios para construir aplicaciones MCP reales
- Recursos adicionales para estudiantes avanzados
Eventos
MCP Dev Days Julio 2025
➡️Ver Bajo Demanda - MCP Dev Days
Prepárate para dos días de profundo conocimiento técnico, conexión comunitaria 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 y las herramientas que dependen de ellos.
Puedes ver MCP Dev Days registrándote en nuestra página del evento: https://aka.ms/mcpdevdays.
Día 1: Productividad MCP, Herramientas de Desarrollo y Comunidad:
Se trata de empoderar a los desarrolladores para usar MCP en su flujo de trabajo y celebrar la increíble comunidad MCP. Estaremos acompañados por miembros de la comunidad y socios como Arcade, Block, Okta y Neon para ver cómo están colaborando con Microsoft para dar forma a un ecosistema MCP abierto y extensible.
Demos del mundo real en VS Code, Visual Studio, GitHub Copilot y herramientas populares de la comunidad
Flujos de trabajo prácticos y orientados al contexto
Sesiones lideradas por la comunidad e ideas
Ya sea que estés comenzando con MCP o ya estés construyendo con él, el Día 1 establecerá el escenario con inspiración y consejos prácticos.
Día 2: Construye Servidores MCP con Confianza
Está dirigido a constructores de 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 impulsado por prompts
- Mejores prácticas de seguridad
- Uso de bloques de construcción 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 ideas que necesitas para construir soluciones MCP escalables, seguras y preparadas para el futuro.
Boot Camp MCP Agosto 2025
Aprende en sesiones intensivas de video cómo crear servidores MCP, integrarte con VS Code y desplegar profesionalmente en Azure basado en contenido del currículo MCP para principiantes. Adquiere habilidades prácticas en una tecnología que ya están utilizando grandes empresas.
➡️Ver Bajo Demanda Bootcamp MCP | Inglés
➡️Ver Bajo Demanda Bootcamp MCP | Brasil
➡️Ver Bajo Demanda Bootcamp MCP | Español
Aprendamos MCP con C# - Serie de Tutoriales
Aprendamos sobre el Protocolo de Contexto de Modelo (MCP), un marco innovador diseñado para estandarizar las interacciones entre modelos de IA y aplicaciones cliente. A través de esta sesión amigable para principiantes, te introduciremos a MCP y te guiaremos para crear tu primer servidor MCP.
C#: https://aka.ms/letslearnmcp-csharp
Java: https://aka.ms/letslearnmcp-java
JavaScript: https://aka.ms/letslearnmcp-javascript
Python: https://aka.ms/letslearnmcp-python
🌟 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 de Contribución
Este proyecto da la bienvenida a contribuciones y sugerencias. La mayoría de las contribuciones requieren que aceptes un Acuerdo de Licencia de Contribuyente (CLA) declarando que tienes el derecho de, y realmente 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 decorará el PR apropiadamente (por ejemplo, verificación de estado, comentario). Simplemente sigue las instrucciones proporcionadas por el bot. Solo necesitarás hacer esto una vez en todos los repositorios que usen 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 con cualquier pregunta o comentario adicional.
📂 Estructura del Repositorio
El repositorio está organizado de la siguiente manera:
- Currículo Central (00-11): El contenido principal organizado en once módulos secuenciales, incluyendo laboratorios completos de integración de bases de datos
- 11-MCPServerHandsOnLabs/: Ruta de aprendizaje completa de 13 laboratorios para construir servidores MCP listos para producción con integración de PostgreSQL
- images/: Diagramas e ilustraciones utilizados 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 significativos 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! Revisa:
- NUEVO Edge AI Para Principiantes
- Agentes de IA Para Principiantes
- IA Generativa para Principiantes usando .NET
- IA Generativa para Principiantes usando JavaScript
- IA Generativa para Principiantes
- IA Generativa para Principiantes usando Java
- ML para Principiantes
- Ciencia de Datos para Principiantes
- IA para Principiantes
- Ciberseguridad para Principiantes
- Desarrollo Web para Principiantes
- IoT para Principiantes
- Desarrollo XR para Principiantes
- Dominando GitHub Copilot para Programación en Pareja con IA
- Domina GitHub Copilot para desarrolladores de C#/.NET
- Elige tu propia aventura con Copilot
™️ Aviso de Marca Registrada
Este proyecto puede contener marcas registradas o logotipos de proyectos, productos o servicios. El uso autorizado de las marcas registradas o logotipos de Microsoft está sujeto a y debe cumplir con las Directrices de Marca y Logotipo de Microsoft.
El uso de marcas registradas o logotipos de Microsoft en versiones modificadas de este proyecto no debe causar confusión ni implicar patrocinio por parte de Microsoft.
Cualquier uso de marcas registradas o logotipos de terceros está sujeto a las políticas de esos terceros.
Obtener Ayuda
Si te quedas atascado o tienes preguntas sobre cómo construir aplicaciones de IA, únete a:
Si tienes comentarios sobre el producto o errores mientras construyes, visita:
Descargo de responsabilidad:
Este documento ha sido traducido utilizando el servicio de traducción automática Co-op Translator. Aunque nos esforzamos por garantizar la precisión, tenga en cuenta que las traducciones automatizadas pueden contener errores o imprecisiones. El documento original en su idioma nativo debe considerarse como la fuente autorizada. Para información crítica, se recomienda una traducción profesional realizada por humanos. No nos hacemos responsables de malentendidos o interpretaciones erróneas que puedan surgir del uso de esta traducción.