Следуйте этим шагам, чтобы начать работу с этими ресурсами:
- Сделайте форк репозитория: Нажмите
- Клонируйте репозиторий:
git clone https://github.com/microsoft/mcp-for-beginners.git - Присоединяйтесь к Azure AI Foundry Discord, чтобы встретиться с экспертами и другими разработчиками
French | Spanish | German | Russian | Arabic | Persian (Farsi) | Urdu | Chinese (Simplified) | Chinese (Traditional, Macau) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Taiwan) | Japanese | Korean | Hindi | Bengali | Marathi | Nepali | Punjabi (Gurmukhi) | Portuguese (Portugal) | Portuguese (Brazil) | Italian | Polish | Turkish | Greek | Thai | Swedish | Danish | Norwegian | Finnish | Dutch | Hebrew | Vietnamese | Indonesian | Malay | Tagalog (Filipino) | Swahili | Hungarian | Czech | Slovak | Romanian | Bulgarian | Serbian (Cyrillic) | Croatian | Slovenian | Ukrainian | Burmese (Myanmar)
Model Context Protocol (MCP) — это современный фреймворк, созданный для стандартизации взаимодействия между AI-моделями и клиентскими приложениями. Этот открытый учебный курс предлагает структурированный путь обучения с практическими примерами кода и реальными кейсами на популярных языках программирования, включая C#, Java, JavaScript, TypeScript и Python.
Будь вы разработчиком AI, системным архитектором или инженером-программистом, это руководство станет вашим полным ресурсом для освоения основ MCP и стратегий его внедрения.
- 📘 Документация MCP – Подробные руководства и инструкции
- 📜 Спецификация MCP – Архитектура протокола и технические справочники
- 📜 Оригинальная спецификация MCP – Устаревшие технические справочники (может содержать дополнительные детали)
- 🧑💻 GitHub репозиторий MCP – Открытые SDK, инструменты и примеры кода
- 🌐 Сообщество MCP – Присоединяйтесь к обсуждениям и вносите свой вклад
Приготовьтесь к двум дням глубоких технических знаний, общения с сообществом и практического обучения на MCP Dev Days — виртуальном мероприятии, посвящённом Model Context Protocol (MCP) — новому стандарту, который объединяет AI-модели и инструменты, на которых они основаны.
➡️ Регистрация на MCP Dev Days
Вы сможете смотреть MCP Dev Days, зарегистрировавшись на странице мероприятия: https://aka.ms/mcpdevdays. Оттуда вы сможете присоединиться к прямой трансляции на YouTube или Twitch. Все материалы будут записаны и доступны позже на канале Microsoft Developer на YouTube. Исходный код демонстраций также будет доступен на GitHub.
- Даты: 29 июля (День 1) и 30 июля (День 2)
- Время: ежедневно в 9:00 по тихоокеанскому времени (PST)
- Место: онлайн — присоединяйтесь откуда угодно!
Посвящён тому, чтобы помочь разработчикам использовать MCP в своей работе и отметить достижения сообщества MCP. К нам присоединятся участники сообщества и партнёры, такие как Arcade, Block, Okta и Neon, чтобы показать, как они сотрудничают с Microsoft для создания открытой и расширяемой экосистемы MCP. Реальные демонстрации в VS Code, Visual Studio, GitHub Copilot и популярных инструментах сообщества. Практические, контекстно-ориентированные рабочие процессы разработки. Сессии и инсайты от сообщества. Если вы только начинаете работать с MCP или уже создаёте решения на его основе, День 1 вдохновит вас и даст полезные рекомендации.
Для разработчиков MCP. Мы подробно рассмотрим стратегии реализации и лучшие практики создания MCP серверов и интеграции MCP в ваши AI-процессы.
- Создание MCP серверов и интеграция их в агентские решения
- Разработка на основе подсказок (prompt-driven development)
- Лучшие практики безопасности
- Использование строительных блоков, таких как Functions, ACA и API Management
- Согласование реестров и инструменты (1P + 3P)
Если вы разработчик, создатель инструментов или стратег AI-продуктов, этот день наполнен знаниями, необходимыми для создания масштабируемых, безопасных и готовых к будущему решений MCP.
| Модуль | Тема | Описание | Ссылка |
|---|---|---|---|
| Модули 1-3: Основы | |||
| 00 | Введение в MCP | Обзор Model Context Protocol и его значение в 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 | SSE сервер | Создание серверов с использованием Server-Sent Events | Руководство |
| 3.6 | HTTP стриминг | Реализация HTTP стриминга в MCP | Руководство |
| 3.7 | AI Toolkit | Использование AI Toolkit с MCP | Руководство |
| 3.8 | Тестирование | Тестирование реализации MCP сервера | Руководство |
| 3.9 | Развёртывание | Развёртывание MCP серверов в продакшн | Руководство |
| Модули 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 | Контекстное проектирование | Методы эффективного контекстного проектирования | Руководство |
| Модули 6-10: Сообщество и лучшие практики | |||
| 06 | Вклад сообщества | Как внести свой вклад в экосистему MCP | Руководство |
| 07 | Опыт раннего внедрения | Реальные истории внедрения | Руководство |
| 08 | Лучшие практики MCP | Производительность, отказоустойчивость, устойчивость | Руководство |
| 09 | Кейсы MCP | Практические примеры реализации | Руководство |
| 10 | Практический семинар | Создание MCP сервера с AI Toolkit | Лабораторная работа |
| Язык | Описание | Ссылка |
|---|---|---|
| C# | Пример MCP сервера | Посмотреть код |
| Java | Калькулятор MCP | Посмотреть код |
| JavaScript | Демонстрация MCP | Посмотреть код |
| Python | MCP сервер | Посмотреть код |
| TypeScript | Пример MCP | Посмотреть код |
| Язык | Описание | Ссылка |
|---|---|---|
| C# | Продвинутый пример | Посмотреть код |
| Java | Пример контейнерного приложения | Посмотреть код |
| JavaScript | Продвинутый пример | Посмотреть код |
| Python | Сложная реализация | Посмотреть код |
| TypeScript | Пример контейнера | Посмотреть код |
Чтобы максимально эффективно использовать этот курс, вам потребуется:
-
Базовые знания программирования хотя бы на одном из языков: C#, Java, JavaScript, Python или TypeScript
-
Понимание клиент-серверной модели и API
-
Знакомство с концепциями REST и HTTP
-
(Опционально) Знания в области ИИ/машинного обучения
-
Участие в обсуждениях нашего сообщества для поддержки
В этом репозитории собраны различные материалы, которые помогут вам эффективно учиться и ориентироваться:
Доступно подробное Руководство по обучению, которое поможет вам ориентироваться в репозитории. В руководстве вы найдете:
- Визуальную карту учебной программы со всеми темами
- Подробное описание каждого раздела репозитория
- Инструкции по использованию примеров проектов
- Рекомендованные пути обучения для разных уровней подготовки
- Дополнительные ресурсы для углубленного изучения
Мы ведем подробный Журнал изменений, в котором фиксируем все важные обновления учебных материалов, включая:
- Добавление нового контента
- Изменения в структуре
- Улучшения функционала
- Обновления документации
Каждый урок в этом руководстве включает:
- Понятные объяснения концепций MCP
- Примеры кода на нескольких языках
- Упражнения для создания реальных MCP приложений
- Дополнительные материалы для продвинутых пользователей
Особая благодарность Microsoft Valued Professional Shivam Goyal за вклад важных примеров кода.
Этот контент распространяется под MIT License. Условия использования смотрите в файле LICENSE.
Этот проект приветствует ваши предложения и вклад. Большинство изменений требуют согласия с Contributor License Agreement (CLA), подтверждающим, что вы имеете право и действительно предоставляете нам права на использование вашего вклада. Подробнее на https://cla.opensource.microsoft.com.
При создании pull request, бот CLA автоматически определит, нужно ли вам подписывать CLA, и отметит PR соответствующим образом (например, проверкой статуса или комментарием). Просто следуйте инструкциям бота. Это нужно сделать только один раз для всех репозиториев, использующих наш CLA.
Проект придерживается Microsoft Open Source Code of Conduct. Подробнее см. в FAQ по Кодексу поведения или свяжитесь с opencode@microsoft.com для дополнительных вопросов или комментариев.
Репозиторий организован следующим образом:
- Основная учебная программа (00-10): основной контент, разбитый на десять последовательных модулей
- images/: диаграммы и иллюстрации, используемые в курсе
- translations/: поддержка нескольких языков с автоматическим переводом
- translated_images/: локализованные версии диаграмм и иллюстраций
- study_guide.md: подробное руководство по навигации в репозитории
- changelog.md: журнал всех значимых изменений учебных материалов
- mcp.json: файл конфигурации спецификации MCP
- CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: документы по управлению проектом
Наша команда выпускает и другие курсы! Ознакомьтесь с ними:
- AI Agents For Beginners
- Generative AI for Beginners using .NET
- Generative AI for Beginners using JavaScript
- Generative AI for Beginners
- ML for Beginners
- Data Science for Beginners
- AI for Beginners
- Cybersecurity for Beginners
- Web Dev for Beginners
- IoT for Beginners
- XR Development for Beginners
- Mastering GitHub Copilot for AI Paired Programming
- Mastering GitHub Copilot for C#/.NET Developers
- Choose Your Own Copilot Adventure
В этом проекте могут использоваться товарные знаки или логотипы проектов, продуктов или услуг. Авторизованное использование товарных знаков или логотипов Microsoft регулируется и должно соответствовать Правилам использования товарных знаков и брендов Microsoft. Использование товарных знаков или логотипов Microsoft в изменённых версиях проекта не должно вводить в заблуждение или создавать впечатление спонсорства со стороны Microsoft. Использование товарных знаков или логотипов третьих сторон регулируется политиками этих сторон.
Отказ от ответственности:
Этот документ был переведен с помощью сервиса автоматического перевода Co-op Translator. Несмотря на наши усилия по обеспечению точности, просим учитывать, что автоматический перевод может содержать ошибки или неточности. Оригинальный документ на его исходном языке следует считать авторитетным источником. Для получения критически важной информации рекомендуется обращаться к профессиональному переводу, выполненному человеком. Мы не несем ответственности за любые недоразумения или неправильные толкования, возникшие в результате использования данного перевода.