Следуйте этим шагам, чтобы начать использовать данные ресурсы:
- Сделайте форк репозитория: Нажмите
- Клонируйте репозиторий:
git clone https://github.com/microsoft/mcp-for-beginners.git - Присоединяйтесь к Discord Azure AI Foundry, чтобы встретиться с экспертами и разработчиками
🌐 Поддержка нескольких языков
Поддерживается через GitHub Action (автоматически и всегда актуально)
Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Korean | Malay | Marathi | Nepali | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Thai | Turkish | Ukrainian | Urdu | Vietnamese
🚀 Учебный курс по протоколу контекста модели (MCP) для начинающих
Изучите MCP с практическими примерами кода на C#, Java, JavaScript, Rust, Python и TypeScript
🧠 Обзор учебного курса по протоколу контекста модели
Протокол контекста модели (MCP) — это современная структура, разработанная для стандартизации взаимодействий между AI-моделями и клиентскими приложениями. Этот открытый учебный курс предлагает структурированный путь обучения с практическими примерами кода и реальными кейсами на популярных языках программирования, таких как C#, Java, JavaScript, TypeScript и Python.
Будь вы разработчиком AI, системным архитектором или инженером-программистом, этот гид станет вашим всеобъемлющим ресурсом для освоения основ MCP и стратегий его внедрения.
🔗 Официальные ресурсы MCP
- 📘 Документация MCP – Подробные руководства и учебные материалы
- 📜 Спецификация MCP – Архитектура протокола и технические ссылки
- 📜 Оригинальная спецификация MCP – Технические ссылки на старую версию (может содержать дополнительные детали)
- 🧑💻 Репозиторий MCP на GitHub – Открытые SDK, инструменты и примеры кода
- 🌐 Сообщество MCP – Присоединяйтесь к обсуждениям и вносите свой вклад в сообщество
🧭 Обзор учебного курса MCP
📚 Полная структура курса
| Модуль | Тема | Описание | Ссылка |
|---|---|---|---|
| Модули 1-3: Основы | |||
| 00 | Введение в MCP | Обзор протокола контекста модели и его значимости в AI-пайплайнах | Подробнее |
| 01 | Основные концепции | Подробное изучение ключевых концепций MCP | Подробнее |
| 02 | Безопасность в MCP | Угрозы безопасности и лучшие практики | Подробнее |
| 03 | Начало работы с MCP | Настройка окружения, базовые серверы/клиенты, интеграция | Подробнее |
| Модуль 3: Создание первого сервера и клиента | |||
| 3.1 | Первый сервер | Создайте свой первый сервер MCP | Руководство |
| 3.2 | Первый клиент | Разработайте базовый клиент MCP | Руководство |
| 3.3 | Клиент с LLM | Интеграция больших языковых моделей | Руководство |
| 3.4 | Интеграция с VS Code | Использование серверов MCP в VS Code | Руководство |
| 3.5 | Сервер stdio | Создание серверов с использованием транспорта stdio | Руководство |
| 3.6 | HTTP-стриминг | Реализация HTTP-стриминга в MCP | Руководство |
| 3.7 | AI Toolkit | Использование AI Toolkit с MCP | Руководство |
| 3.8 | Тестирование | Тестирование реализации вашего сервера MCP | Руководство |
| 3.9 | Развертывание | Развертывание серверов MCP в продакшн | Руководство |
| 3.10 | Расширенное использование серверов | Использование продвинутых серверов для улучшенной архитектуры | Руководство |
| 3.11 | Простая аутентификация | Глава, показывающая основы аутентификации и RBAC | Руководство |
| Модули 4-5: Практика и углубленное изучение | |||
| 04 | Практическая реализация | SDK, отладка, тестирование, шаблоны запросов | Подробнее |
| 05 | Углубленные темы MCP | Мультимодальный AI, масштабирование, корпоративное использование | Подробнее |
| 5.1 | Интеграция с Azure | MCP и Azure | Руководство |
| 5.2 | Мультимодальность | Работа с несколькими модальностями | Руководство |
| 5.3 | Демонстрация OAuth2 | Реализация аутентификации OAuth2 | Руководство |
| 5.4 | Корневые контексты | Понимание и реализация корневых контекстов | Руководство |
| 5.5 | Маршрутизация | Стратегии маршрутизации MCP | Руководство |
| 5.6 | Семплирование | Техники семплирования в MCP | Руководство |
| 5.7 | Масштабирование | Масштабирование реализации MCP | Руководство |
| 5.8 | Безопасность | Углубленные аспекты безопасности | Руководство |
| 5.9 | Веб-поиск | Реализация возможностей веб-поиска | Руководство |
| 5.10 | Реальный стриминг | Создание функционала реального стриминга | Руководство |
| 5.11 | Реальный поиск | Реализация реального поиска | Руководство |
| 5.12 | Аутентификация Entra ID | Аутентификация с Microsoft Entra ID | Руководство |
| 5.13 | Интеграция с Foundry | Интеграция с Azure AI Foundry | Руководство |
| 5.14 | Инженерия контекста | Техники эффективной инженерии контекста | Руководство |
| 5.15 | Пользовательский транспорт MCP | Реализация пользовательских транспортов | Руководство |
| Модули 6-10: Сообщество и лучшие практики | |||
| 06 | Вклад сообщества | Как внести вклад в экосистему MCP | Руководство |
| 07 | Уроки раннего внедрения | Реальные истории реализации | Руководство |
| 08 | Лучшие практики MCP | Производительность, отказоустойчивость, устойчивость | Руководство |
| 09 | Кейсы MCP | Примеры практической реализации | Руководство |
| 10 | Практическая мастерская | Создание сервера MCP с AI Toolkit | Лаборатория |
| Модуль 11: Практическая лаборатория по серверу MCP | |||
| 11 | Интеграция сервера MCP с базой данных | Полный учебный путь из 13 лабораторий для интеграции с PostgreSQL | Лаборатории |
| 11.1 | Введение | Обзор MCP с интеграцией базы данных и кейс аналитики розничной торговли | Лаборатория 00 |
| 11.2 | Основная архитектура | Понимание архитектуры сервера MCP, уровней базы данных и моделей безопасности | Лаборатория 01 |
| 11.3 | Безопасность и многопользовательский доступ | Безопасность на уровне строк, аутентификация и доступ к данным для нескольких арендаторов | Лаборатория 02 |
| 11.4 | Настройка окружения | Настройка среды разработки, Docker, ресурсов Azure | Лаборатория 03 |
| 11.5 | Проектирование базы данных | Настройка PostgreSQL, проектирование схемы для ритейла и пример данных | Лаборатория 04 |
| 11.6 | Реализация сервера MCP | Создание сервера FastMCP с интеграцией базы данных | Лаборатория 05 |
| 11.7 | Разработка инструментов | Создание инструментов для запросов к базе данных и анализа схемы | Лаборатория 06 |
| 11.8 | Семантический поиск | Реализация векторных эмбеддингов с Azure OpenAI и pgvector | Лаборатория 07 |
| 11.9 | Тестирование и отладка | Стратегии тестирования, инструменты отладки и подходы к проверке | Лаборатория 08 |
| 11.10 | Интеграция с VS Code | Настройка интеграции MCP с VS Code и использование AI Chat | Лаборатория 09 |
| 11.11 | Стратегии развертывания | Развертывание с Docker, Azure Container Apps и масштабирование | Лаборатория 10 |
| 11.12 | Мониторинг | Application Insights, логирование, мониторинг производительности | Лаборатория 11 |
| 11.13 | Лучшие практики | Оптимизация производительности, усиление безопасности и советы для продакшена | Лаборатория 12 |
💻 Примеры кода
Примеры базового калькулятора MCP
| Язык | Описание | Ссылка |
|---|---|---|
| C# | Пример сервера MCP | Посмотреть код |
| Java | Калькулятор MCP | Посмотреть код |
| JavaScript | Демонстрация MCP | Посмотреть код |
| Python | Сервер MCP | Посмотреть код |
| TypeScript | Пример MCP | Посмотреть код |
| Rust | Пример MCP | Посмотреть код |
Расширенные реализации MCP
| Язык | Описание | Ссылка |
|---|---|---|
| C# | Расширенный пример | Посмотреть код |
| Java с Spring | Пример приложения в контейнере | Посмотреть код |
| JavaScript | Расширенный пример | Посмотреть код |
| Python | Сложная реализация | Посмотреть код |
| TypeScript | Пример контейнера | Посмотреть код |
🎯 Предварительные требования для изучения MCP
Чтобы максимально эффективно изучить этот материал, вам потребуется:
Базовые знания программирования на одном из следующих языков: C#, Java, JavaScript, Python или TypeScript
Понимание модели клиент-сервер и API
Знакомство с концепциями REST и HTTP
(Опционально) Основы AI/ML
Участие в обсуждениях сообщества для получения поддержки
📚 Руководство по обучению и ресурсы
Этот репозиторий включает множество ресурсов, которые помогут вам эффективно изучать материал:
Руководство по обучению
Детальное Руководство по обучению доступно для того, чтобы помочь вам эффективно ориентироваться в этом репозитории. В руководстве содержится:
- Визуальная карта учебной программы с охватом всех тем
- Подробное описание каждой секции репозитория
- Рекомендации по использованию примеров проектов
- Рекомендуемые пути обучения для разных уровней навыков
- Дополнительные ресурсы для углубленного изучения
Журнал изменений
Мы ведем подробный Журнал изменений, где фиксируем все значительные обновления учебных материалов, включая:
- Добавление нового контента
- Структурные изменения
- Улучшения функций
- Обновления документации
🛠️ Как эффективно использовать эту учебную программу
Каждый урок в этом руководстве включает:
- Понятные объяснения концепций MCP
- Примеры кода в реальном времени на нескольких языках
- Упражнения для создания реальных приложений MCP
- Дополнительные ресурсы для продвинутых пользователей
События
MCP Dev Days июль 2025
➡️Смотреть запись - MCP Dev Days
Приготовьтесь к двум дням глубокого технического погружения, общения с сообществом и практического обучения на MCP Dev Days — виртуальном мероприятии, посвященном Model Context Protocol (MCP), новому стандарту, который объединяет AI-модели и инструменты, на которых они основаны. Вы можете посмотреть MCP Dev Days, зарегистрировавшись на странице мероприятия: https://aka.ms/mcpdevdays.
День 1: Продуктивность MCP, инструменты разработки и сообщество:
Посвящен тому, чтобы помочь разработчикам использовать MCP в их рабочем процессе и отметить достижения сообщества MCP. Мы будем работать с участниками сообщества и партнерами, такими как Arcade, Block, Okta и Neon, чтобы увидеть, как они сотрудничают с Microsoft для создания открытой и расширяемой экосистемы MCP. Реальные демонстрации с использованием VS Code, Visual Studio, GitHub Copilot и популярных инструментов сообщества Практические, контекстно-ориентированные рабочие процессы разработки Сессии, проводимые сообществом, и полезные инсайты Независимо от того, только ли вы начинаете работать с MCP или уже создаете с его помощью, День 1 вдохновит вас и предоставит полезные рекомендации.
День 2: Создание серверов MCP с уверенностью
Посвящен разработчикам MCP. Мы углубимся в стратегии реализации и лучшие практики для создания серверов MCP и интеграции MCP в ваши AI-рабочие процессы.
Темы включают:
- Создание серверов MCP и их интеграция в агентные сценарии
- Разработка, основанная на подсказках
- Лучшие практики безопасности
- Использование строительных блоков, таких как Functions, ACA и API Management
- Согласование реестра и инструменты (1P + 3P)
Если вы разработчик, создатель инструментов или стратег AI-продуктов, этот день наполнен инсайтами, которые помогут вам создавать масштабируемые, безопасные и готовые к будущему решения MCP.
MCP Boot Camp август 2025
Изучите в интенсивных видеосессиях, как создавать серверы MCP, интегрировать их с VS Code и профессионально развертывать на Azure, основываясь на материалах учебной программы MCP для начинающих. Получите практические навыки в технологии, которую уже используют крупные компании.
➡️Смотреть запись MCP Bootcamp | Английский
➡️Смотреть запись MCP Bootcamp | Бразилия
➡️Смотреть запись MCP Bootcamp | Испанский
Давайте изучать MCP с C# - серия уроков
Давайте изучим Model Context Protocol (MCP), передовую структуру, разработанную для стандартизации взаимодействий между AI-моделями и клиентскими приложениями. В этом дружелюбном для начинающих уроке мы познакомим вас с MCP и покажем, как создать ваш первый сервер 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
🌟 Благодарности сообществу
Благодарим Microsoft Valued Professional Шивама Гояла за вклад в важные примеры кода.
📜 Информация о лицензии
Этот контент лицензирован под MIT License. Условия и положения можно найти в LICENSE.
🤝 Руководство по внесению вклада
Этот проект приветствует вклад и предложения. Большинство вкладов требуют от вас согласия с Contributor License Agreement (CLA), подтверждающего, что у вас есть право и вы действительно предоставляете нам права на использование вашего вклада. Подробнее см. https://cla.opensource.microsoft.com.
Когда вы отправляете pull request, бот CLA автоматически определяет, нужно ли вам предоставить CLA и добавляет соответствующую информацию к PR (например, проверку статуса, комментарий). Просто следуйте инструкциям, предоставленным ботом. Вам нужно будет сделать это только один раз для всех репозиториев, использующих наш CLA.
Этот проект принял Кодекс поведения Microsoft Open Source. Для получения дополнительной информации см. FAQ по кодексу поведения или свяжитесь с opencode@microsoft.com с любыми дополнительными вопросами или комментариями.
📂 Структура репозитория
Репозиторий организован следующим образом:
- Основная учебная программа (00-11): Основной контент, организованный в одиннадцать последовательных модулей, включая лаборатории с интеграцией базы данных
- 11-MCPServerHandsOnLabs/: Полный учебный путь из 13 лабораторий для создания готовых к продакшену серверов MCP с интеграцией PostgreSQL
- images/: Диаграммы и иллюстрации, используемые в учебной программе
- translations/: Поддержка нескольких языков с автоматическими переводами
- translated_images/: Локализованные версии диаграмм и иллюстраций
- study_guide.md: Полное руководство по навигации в репозитории
- changelog.md: Запись всех значительных изменений в учебных материалах
- mcp.json: Конфигурационный файл для спецификации MCP
- CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Документы управления проектом
🎒 Другие курсы
Наша команда создает другие курсы! Ознакомьтесь:
- НОВИНКА Edge AI для начинающих
- AI-агенты для начинающих
- Генеративный AI для начинающих с использованием .NET
- Генеративный AI для начинающих с использованием JavaScript
- Генеративный AI для начинающих
- Генеративный AI для начинающих с использованием Java
- ML для начинающих
- Data Science для начинающих
- AI для начинающих
- Кибербезопасность для начинающих
- Веб-разработка для начинающих
- IoT для начинающих
- Разработка XR для начинающих
- Мастерство GitHub Copilot для парного программирования с AI
- Освоение GitHub Copilot для разработчиков C#/.NET
- Выбери свое приключение с Copilot
™️ Уведомление о товарных знаках
Этот проект может содержать товарные знаки или логотипы для проектов, продуктов или услуг. Использование товарных знаков или логотипов Microsoft должно быть авторизовано и соответствовать
Руководству по использованию товарных знаков и брендов Microsoft.
Использование товарных знаков или логотипов Microsoft в модифицированных версиях этого проекта не должно вызывать путаницу или подразумевать спонсорство со стороны Microsoft.
Любое использование товарных знаков или логотипов третьих сторон должно соответствовать политике этих третьих сторон.
Получение помощи
Если вы столкнулись с трудностями или у вас есть вопросы о создании приложений с ИИ, присоединяйтесь:
Если у вас есть отзывы о продукте или ошибки при разработке, посетите:
Отказ от ответственности:
Этот документ был переведен с помощью сервиса автоматического перевода Co-op Translator. Несмотря на наши усилия обеспечить точность, автоматические переводы могут содержать ошибки или неточности. Оригинальный документ на его родном языке следует считать авторитетным источником. Для получения критически важной информации рекомендуется профессиональный перевод человеком. Мы не несем ответственности за любые недоразумения или неправильные интерпретации, возникшие в результате использования данного перевода.