Следуйте этим шагам, чтобы начать использовать данные ресурсы:
- Сделайте форк репозитория: Нажмите
- Клонируйте репозиторий:
git clone https://github.com/microsoft/mcp-for-beginners.git - Присоединяйтесь к Discord Azure AI Foundry, чтобы встретиться с экспертами и разработчиками
Арабский | Бенгальский | Болгарский | Бирманский (Мьянма) | Китайский (упрощенный) | Китайский (традиционный, Гонконг) | Китайский (традиционный, Макао) | Китайский (традиционный, Тайвань) | Хорватский | Чешский | Датский | Голландский | Финский | Французский | Немецкий | Греческий | Иврит | Хинди | Венгерский | Индонезийский | Итальянский | Японский | Корейский | Малайский | Маратхи | Непальский | Норвежский | Персидский (фарси) | Польский | Португальский (Бразилия) | Португальский (Португалия) | Панджаби (Гурмукхи) | Румынский | Русский | Сербский (кириллица) | Словацкий | Словенский | Испанский | Суахили | Шведский | Тагальский (Филиппины) | Тайский | Турецкий | Украинский | Урду | Вьетнамский
Протокол контекста модели (MCP) — это передовая структура, разработанная для стандартизации взаимодействий между AI-моделями и клиентскими приложениями. Этот открытый учебный курс предлагает структурированный путь обучения, включающий практические примеры кода и реальные случаи использования, на популярных языках программирования, таких как C#, Java, JavaScript, TypeScript и Python.
Независимо от того, являетесь ли вы разработчиком AI, системным архитектором или инженером-программистом, это руководство станет вашим всесторонним ресурсом для освоения основ MCP и стратегий его реализации.
- 📘 Документация MCP – Подробные учебные материалы и руководства
- 📜 Спецификация MCP – Архитектура протокола и технические ссылки
- 📜 Оригинальная спецификация MCP – Устаревшие технические ссылки (могут содержать дополнительные детали)
- 🧑💻 Репозиторий MCP на GitHub – Открытые SDK, инструменты и примеры кода
- 🌐 Сообщество 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 в продакшн | Руководство |
| Модули 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 | Посмотреть код |
| Rust | Пример MCP | Посмотреть код |
| Язык | Описание | Ссылка |
|---|---|---|
| C# | Продвинутый пример | View Code |
| Java с Spring | Пример приложения-контейнера | View Code |
| JavaScript | Продвинутый пример | View Code |
| Python | Сложная реализация | View Code |
| TypeScript | Пример контейнера | View Code |
Чтобы максимально эффективно изучить этот курс, вам потребуется:
-
Базовые знания программирования хотя бы на одном из следующих языков: C#, Java, JavaScript, Python или TypeScript
-
Понимание клиент-серверной модели и API
-
Знакомство с концепциями REST и HTTP
-
(Опционально) Основы концепций AI/ML
-
Участие в обсуждениях сообщества для получения поддержки
Этот репозиторий содержит множество ресурсов, которые помогут вам эффективно изучать материал:
Детальное Руководство по обучению доступно для того, чтобы помочь вам эффективно ориентироваться в этом репозитории. В руководстве содержится:
- Визуальная карта учебной программы с перечислением всех тем
- Подробное описание каждой секции репозитория
- Рекомендации по использованию примеров проектов
- Рекомендуемые пути обучения для разных уровней навыков
- Дополнительные ресурсы для углубленного изучения
Мы ведем подробную Историю изменений, где фиксируем все значительные обновления учебных материалов, включая:
- Добавление нового контента
- Структурные изменения
- Улучшения функционала
- Обновления документации
Каждый урок в этом руководстве включает:
- Понятные объяснения концепций MCP
- Примеры кода в реальном времени на нескольких языках
- Упражнения для создания реальных приложений MCP
- Дополнительные ресурсы для продвинутых пользователей
Приготовьтесь к двум дням глубокого технического погружения, общения с сообществом и практического обучения на MCP Dev Days — виртуальном мероприятии, посвященном Model Context Protocol (MCP), новому стандарту, который объединяет AI-модели и инструменты, на которых они основаны.
Вы можете посмотреть MCP Dev Days, зарегистрировавшись на странице мероприятия: https://aka.ms/mcpdevdays.
Посвящен тому, чтобы помочь разработчикам использовать MCP в их рабочем процессе и отметить достижения сообщества MCP. Мы будем работать с участниками сообщества и партнерами, такими как Arcade, Block, Okta и Neon, чтобы увидеть, как они сотрудничают с Microsoft для создания открытой и расширяемой экосистемы MCP.
Реальные демонстрации с использованием VS Code, Visual Studio, GitHub Copilot и популярных инструментов сообщества
Практические, контекстно-ориентированные рабочие процессы разработчиков
Сессии и инсайты, проводимые сообществом
Независимо от того, только ли вы начинаете работать с MCP или уже создаете проекты с его использованием, День 1 вдохновит вас и предоставит полезные рекомендации.
Посвящен разработчикам MCP. Мы углубимся в стратегии реализации и лучшие практики для создания MCP серверов и интеграции MCP в ваши AI рабочие процессы.
- Создание MCP серверов и их интеграция в агентные сценарии
- Разработка, основанная на запросах
- Лучшие практики безопасности
- Использование строительных блоков, таких как Functions, ACA и API Management
- Согласование реестра и инструменты (1P + 3P)
Если вы разработчик, создатель инструментов или стратег AI-продуктов, этот день наполнен инсайтами, которые помогут вам создавать масштабируемые, безопасные и готовые к будущему решения MCP.
Узнайте на интенсивных видеосессиях, как создавать MCP серверы, интегрировать их с VS Code и профессионально развертывать на Azure, основываясь на материалах курса 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. Для получения дополнительной информации смотрите 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
- Generative AI for Beginners using Java
- 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. Несмотря на наши усилия обеспечить точность, автоматические переводы могут содержать ошибки или неточности. Оригинальный документ на его родном языке следует считать авторитетным источником. Для получения критически важной информации рекомендуется профессиональный перевод человеком. Мы не несем ответственности за любые недоразумения или неправильные интерпретации, возникшие в результате использования данного перевода.