Files
2026-07-13 13:31:35 +08:00

54 KiB
Raw Permalink Blame History

MCP-для-начинающих

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Foundry Discord

Следуйте этим шагам, чтобы начать использовать эти ресурсы:

  1. Сделайте форк репозитория: Нажмите GitHub forks
  2. Клонируйте репозиторий: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Присоединяйтесь к Microsoft Foundry Discord

🌐 Многоязычная поддержка

Поддерживается через GitHub Action (автоматизировано и всегда актуально)

Арабский | Бенгальский | Болгарский | Бирманский (Мьянма) | Китайский (упрощённый) | Китайский (традиционный, Гонконг) | Китайский (традиционный, Макао) | Китайский (традиционный, Тайвань) | Хорватский | Чешский | Датский | Нидерландский | Эстонский | Финский | Французский | Немецкий | Греческий | Иврит | Хинди | Венгерский | Индонезийский | Итальянский | Японский | Каннада | Кхмер | Корейский | Литовский | Малайский | Малаялам | Маратхи | Непальский | Нигерийский пиджин | Норвежский | Персидский (фарси) | Польский | Португальский (Бразилия) | Португальский (Португалия) | Панджаби (Гурмукхи) | Румынский | Русский | Сербский (кириллица) | Словацкий | Словенский | Испанский | Суахили | Шведский | Тагальский (филиппинский) | Тамильский | Телугу | Тайский | Турецкий | Украинский | Урду | Вьетнамский

Предпочитаете клонировать локально?

В этом репозитории содержится более 50 переводов на разные языки, что значительно увеличивает размер загрузки. Чтобы клонировать без переводов, используйте sparse checkout:

Bash / macOS / Linux:

git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'

CMD (Windows):

git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"

Это даст вам всё необходимое для прохождения курса с гораздо более быстрой загрузкой.

🚀 Учебный курс Протокола Контекста Модели (MCP) для начинающих

Изучайте MCP с помощью практических примеров кода на C#, Java, JavaScript, Rust, Python и TypeScript

🧠 Обзор учебного курса по Протоколу Контекста Модели

Добро пожаловать в ваше путешествие по Протоколу Контекста Модели! Если вы когда-либо задавались вопросом, как AI-приложения взаимодействуют с разными инструментами и сервисами, вы вот-вот откроете для себя элегантное решение, которое меняет подход разработчиков к созданию интеллектуальных систем.

Представьте MCP как универсальный переводчик для AI-приложений — так же, как USB-порты позволяют подключить любое устройство к вашему компьютеру, MCP позволяет AI-моделям подключаться к любому инструменту или сервису по единому стандарту. Независимо от того, создаёте ли вы своего первого чатбота или работаете над сложными AI-процессами, понимание MCP даст вам возможность создавать более мощные и гибкие приложения.

Этот курс разработан с терпением и заботой о вашем обучении. Мы начнём с простых понятий, которые вам уже знакомы, и постепенно будем развивать ваши навыки через практику на любимом языке программирования. Каждый шаг сопровождается чёткими объяснениями, практическими примерами и поддержкой.

К моменту окончания курса вы будете уверенно создавать свои собственные MCP-серверы, интегрировать их с популярными AI-платформами и понимать, как эта технология формирует будущее разработки AI. Давайте начнём это увлекательное путешествие вместе!

Официальная документация и спецификации

Этот курс соответствует спецификации MCP от 2025-11-25 (последний стабильный релиз). Спецификация MCP использует версионирование на основе дат (формат ГГГГ-ММ-ДД) для ясного отслеживания версий протокола.

Эти ресурсы станут более полезными по мере вашего прогресса, но не испытывайте давления читать всё сразу. Начинайте с тех разделов, которые вам наиболее интересны!

  • 📘 Документация MCP – Ваш основной ресурс с пошаговыми уроками и руководствами пользователя. Документация написана для начинающих, с понятными примерами, которые можно изучать в удобном темпе.
  • 📜 Спецификация MCP – Это ваш всеобъемлющий справочник. В ходе обучения вы будете часто возвращаться сюда, чтобы уточнять детали и изучать продвинутые функции.
  • 📜 Версионирование спецификации MCP – Содержит информацию о истории версий протокола и о том, как MCP использует дату для версионирования.
  • 🧑‍💻 Репозиторий MCP на GitHub – Здесь вы найдёте SDK, инструменты и примеры кода на разных языках программирования. Настоящее сокровище практических примеров и готовых компонентов.
  • 🌐 Сообщество MCP – Присоединяйтесь к другим учащимся и опытным разработчикам для обсуждений о MCP. Здесь царит поддержка, вопросы приветствуются, а знания щедро делятся.

Учебные цели

К концу курса вы будете чувствовать уверенность и воодушевление от новых знаний. Вот что вы освоите:

Понять основы MCP: Вы узнаете, что такое Протокол Контекста Модели и почему он меняет способ взаимодействия AI-приложений, используя понятные аналогии и примеры.

Создать свой первый MCP-сервер: Вы разработаете работающий MCP-сервер на выбранном языке программирования, начиная с простых примеров и постепенно углубляя навыки.

Подключить AI-модели к реальным инструментам: Вы научитесь создавать мост между AI-моделями и реальными сервисами, расширяя возможности ваших приложений.

Реализовать лучшие практики безопасности: Вы поймёте, как обеспечить безопасность MCP-реализаций, защищая ваши приложения и пользователей.

Уверенно развернуть проекты: Вы узнаете, как вывести MCP-проекты из разработки в продакшен с надёжными методами эксплуатации в реальных условиях.

Вступить в сообщество MCP: Вы станете частью растущего сообщества разработчиков, формирующих будущее AI-приложений.

Необходимая база знаний

Прежде чем перейти к специфике MCP, убедимся, что вы комфортно знакомы с базовыми концепциями. Не волнуйтесь, если вы не эксперт — мы объясним всё, что понадобится!

Понимание протоколов (основа)

Протокол — это правила для разговора. Когда вы звоните другу, вы оба знаете, что нужно сказать «привет» при ответе, говорить по очереди и попрощаться в конце. Компьютерным программам тоже нужны такие правила для эффективного общения.

MCP — это протокол, набор согласованных правил, которые помогают AI-моделям и приложениям «общаться» с инструментами и сервисами. Как правила разговора делают общение людей проще, MCP делает связь AI-приложений более надёжной и мощной.

Отношения клиент-сервер (как программы работают вместе)

Вы используете отношения клиент-сервер ежедневно! Когда вы используете браузер (клиент), чтобы зайти на веб-сайт, вы подключаетесь к веб-серверу, который отправляет страницу. Браузер знает, как запросить информацию, а сервер — как ответить.

В MCP ситуация похожая: AI-модели выступают в роли клиентов, запрашивающих информацию или действия, а MCP-серверы предоставляют эти возможности. Это как иметь помощника (сервер), к которому AI может обратиться с задачами.

Почему важна стандартизация (чтобы всё работало вместе)

Представьте, что у каждого производителя автомобилей разные формы бензозаправочных пистолетов — вам бы понадобился адаптер для каждой машины! Стандартизация значит договориться о едином подходе для совместимости.

MCP обеспечивает такую стандартизацию для AI-приложений. Вместо того, чтобы писать отдельный код для каждой модели и инструмента, MCP создаёт универсальный способ для их взаимодействия. Это позволяет разработчикам создавать инструменты один раз — и использовать их с разными AI-системами.

🧭 Обзор пути обучения

Ваше обучение MCP тщательно структурировано для постепенного увеличения уверенности и навыков. Каждый этап знакомит с новыми понятиями, закрепляя пройденное.

🌱 Фаза основы: понимание базовых концепций (модули 0-2)

Здесь начинается ваше путешествие! Мы познакомим вас с концепциями MCP, используя знакомые аналогии и простые примеры. Вы узнаете, что такое MCP, зачем он нужен и как вписывается в мир разработки AI.

Модуль 0 — Введение в MCP: Мы начнём с изучения, что такое MCP и почему он так важен для современных AI-приложений. Вы увидите реальные примеры использования MCP и поймёте, как он решает типичные задачи разработчиков.

Модуль 1 — Основные концепции: Здесь вы освоите ключевые строительные блоки MCP. Мы используем много аналогий и визуальных примеров, чтобы сделать эти идеи понятными и естественными.

Модуль 2 — Безопасность в MCP: Безопасность может показаться сложной, но мы покажем, как MCP включает встроенные защитные механизмы и расскажем лучшие практики для защиты ваших приложений с самого начала.

🔨 Фаза создания: разработка первых реализаций (модуль 3)

Теперь начинается настоящее веселье! Вы получите практический опыт создания реальных MCP серверов и клиентов. Не волнуйтесь — мы начнем с простого и проведем вас через каждый шаг.

В этом модуле содержится несколько практических руководств, которые позволят вам тренироваться на выбранном вами языке программирования. Вы создадите свой первый сервер, разработаете клиента для подключения к нему и даже интегрируетесь с популярными инструментами разработки, такими как VS Code.

Каждое руководство содержит полный пример кода, советы по устранению неполадок и объяснения, почему мы принимаем те или иные решения в дизайне. К концу этого этапа у вас будут рабочие реализации MCP, которыми можно гордиться!

🚀 Фаза роста: продвинутые концепции и применение в реальном мире (Модули 4-5)

Освоив основы, вы готовы изучать более сложные функции MCP. Мы рассмотрим практические стратегии реализации, техники отладки и продвинутые темы, такие как интеграция мульти-модальной ИИ.

Вы также узнаете, как масштабировать свои реализации MCP для производственного использования и интегрировать их с облачными платформами, такими как Azure. Эти модули подготовят вас к созданию MCP решений, способных справляться с реальными требованиями.

🌟 Фаза мастерства: сообщество и специализация (Модули 6-11)

Заключительный этап фокусируется на присоединении к сообществу MCP и специализации в тех областях, которые вам наиболее интересны. Вы узнаете, как вносить вклад в проекты MCP с открытым исходным кодом, реализовывать продвинутые схемы аутентификации и создавать комплексные решения с интеграцией баз данных.

Особого упоминания заслуживает Модуль 11 — это полный практический курс из 13 лабораторных работ, который научит вас строить производственные MCP серверы с интеграцией PostgreSQL. Это своего рода итоговый проект, объединяющий все, что вы изучили!

📚 Полная структура учебной программы

Модуль Тема Описание Ссылка
Модули 0-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 Сервер stdio Создание серверов с использованием stdio транспорта Руководство
3.6 HTTP потоковая передача Реализация HTTP потоковой передачи в MCP Руководство
3.7 Microsoft Foundry Toolkit Использование Microsoft Foundry Toolkit с MCP Руководство
3.8 Тестирование Тестирование реализации MCP сервера Руководство
3.9 Развертывание Развертывание MCP серверов в продакшен Руководство
3.10 Продвинутое использование сервера Использование продвинутых серверов для расширенных функций и улучшенной архитектуры Руководство
3.11 Простая аутентификация Глава, показывающая аутентификацию с самого начала и RBAC Руководство
3.12 MCP Hosts Настройка Claude Desktop, Cursor, Cline и других MCP хостов Руководство
3.13 MCP Inspector Отладка и тестирование MCP серверов с помощью инструмента Inspector Руководство
3.14 Сэмплирование Использование сэмплирования для взаимодействия с клиентом Руководство
3.15 MCP Apps Разработка MCP приложений Руководство
Модули 4-5: Практические и Продвинутые
04 Практическая реализация SDK, отладка, тестирование, повторно используемые шаблоны подсказок Подробнее
4.1 Пагинация Обработка больших наборов результатов с помощью пагинации на основе курсора Руководство
05 Продвинутые темы MCP Мульти-модальная ИИ, масштабирование, корпоративное использование Подробнее
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 Интеграция с Microsoft Foundry Руководство
5.14 Инжиниринг контекста Техники эффективного инжиниринга контекста Руководство
5.15 Пользовательский транспорт MCP Реализация пользовательских транспортов Руководство
5.16 Особенности протокола Уведомления о прогрессе, отмена, шаблоны ресурсов Руководство
5.17 Противоборствующее многоагентное рассуждение Два агента спорят противоположные стороны, используя общие инструменты MCP, оцениваемые судьей Руководство
Модули 6-10: Сообщество и лучшие практики
06 Вклад сообщества Как вносить вклад в экосистему MCP Руководство
07 Уроки раннего внедрения Истории из реальных внедрений Руководство
08 Лучшие практики MCP Производительность, отказоустойчивость, устойчивость Руководство
09 Кейсы MCP Практические примеры реализации Руководство
10 Практический семинар Создание MCP сервера с Microsoft Foundry 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
Модуль 12: Инструментарий MCP
12.1 Инструментарий Использование MCP в приложении Copilot Руководство

💻 Примеры проектов с кодом

Одна из самых захватывающих частей изучения MCP — это видеть, как ваши навыки программирования развиваются постепенно. Мы спроектировали наши примеры кода начиная с простых и становящихся постепенно более сложными по мере углубления вашего понимания. Вот как мы представляем концепции — с кодом, который легко понять, но который демонстрирует реальные принципы MCP, вы поймете не только что делает этот код, но и почему он так структурирован и как он вписывается в большие MCP приложения.

Примеры простого MCP калькулятора

Язык Описание Ссылка
C# Пример MCP сервера Посмотреть код
Java MCP калькулятор Посмотреть код
JavaScript Демонстрация MCP Посмотреть код
Python MCP сервер Посмотреть код
TypeScript Пример MCP Посмотреть код
Rust Пример MCP Посмотреть код

Продвинутые реализации MCP

Язык Описание Ссылка
C# Продвинутый пример Посмотреть код
Java с Spring Пример Container App Просмотреть код
JavaScript Расширенный пример Просмотреть код
Python Сложная реализация Просмотреть код
TypeScript Пример Container Просмотреть код

🎯 Требования для изучения MCP

Чтобы максимально эффективно использовать эту программу обучения, вам необходимо:

  • Базовые знания программирования как минимум на одном из следующих языков: C#, Java, JavaScript, Python или TypeScript

  • Понимание клиент-серверной модели и API

  • Знакомство с концепциями REST и HTTP

  • (Необязательно) Знания в области ИИ/машинного обучения

  • Участие в наших сообществах для поддержки

📚 Руководство по изучению и ресурсы

В этом репозитории содержится несколько ресурсов, которые помогут вам эффективно ориентироваться и учиться:

Руководство по изучению

Доступно подробное Руководство по изучению, которое поможет вам эффективно использовать этот репозиторий. Эта визуальная карта учебной программы показывает, как все темы связаны друг с другом, и предоставляет рекомендации по эффективному использованию примеров проектов. Это особенно полезно, если вы визуальный ученик, который любит видеть общую картину.

В руководстве есть:

  • Визуальная карта учебной программы со всеми освещёнными темами
  • Подробный разбор каждой части репозитория
  • Рекомендации по использованию образцовых проектов
  • Рекомендованные пути обучения для разных уровней навыков
  • Дополнительные ресурсы, дополняющие ваше обучение

Журнал изменений

Мы ведём подробный Журнал изменений, в котором отслеживаем все значимые обновления учебных материалов, чтобы вы могли быть в курсе последних улучшений и дополнений.

  • Добавление нового контента
  • Структурные изменения
  • Улучшения функциональности
  • Обновления документации

🛠️ Как эффективно использовать эту программу обучения

Каждый урок включает:

  1. Чёткие объяснения концепций MCP
  2. Примеры кода с живым исполнением на нескольких языках
  3. Упражнения для создания реальных MCP-приложений
  4. Дополнительные ресурсы для продвинутых студентов

Давайте изучать MCP с C# - серия уроков

Давайте познакомимся с Model Context Protocol (MCP), передовым фреймворком, созданным для стандартизации взаимодействий между ИИ-моделями и клиентскими приложениями. В этом уроке для начинающих мы введём вас в 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

🎓 Ваше путешествие в мир MCP начинается

Поздравляем! Вы сделали первый шаг в захватывающем путешествии, которое расширит ваши программные возможности и подключит вас к передовым разработкам в области ИИ.

Что вы уже достигли

Прочитав это введение, вы уже начали строить основу своих знаний о MCP. Вы понимаете, что такое MCP, почему это важно и как эта учебная программа поможет вам учиться. Это значительное достижение и начало вашего экспертного пути в этой важной технологии.

Приключения впереди

Продвигаясь по модулям, помните, что каждый эксперт когда-то был новичком. Концепции, которые сейчас могут казаться сложными, со временем станут для вас вторым естеством благодаря практике и применению. Каждый маленький шаг приближает вас к мощным навыкам, которые послужат вам в течение всей карьеры разработчика.

Ваша поддержка

Вы присоединяетесь к сообществу учащихся и экспертов, которые увлечены MCP и готовы помочь другим добиться успеха. Если вы застряли на задаче или хотите поделиться удачей, сообщество здесь, чтобы поддержать вас.

Если у вас возникнут трудности или вопросы по созданию ИИ-приложений, присоединяйтесь к обсуждениям с другими учениками и опытными разработчиками MCP. Это поддерживающее сообщество, где приветствуются вопросы и свободно обмениваются знаниями.

Microsoft Foundry Discord

Если у вас есть отзывы по продукту или ошибки при разработке, посетите:

Microsoft Foundry Developer Forum

Готовы начать?

Ваше приключение с MCP начинается прямо сейчас! Начните с Модуля 0, чтобы погрузиться в первые практические опыт работы с MCP, или исследуйте образцовые проекты, чтобы увидеть, что вам предстоит создавать. Помните — каждый эксперт начинал именно там, где находитесь вы сейчас, и с терпением и практикой будете поражены тем, чего сможете добиться.

Добро пожаловать в мир разработки с Model Context Protocol. Давайте создадим что-то потрясающее вместе!

🤝 Вклад в сообщество обучения

Эта учебная программа становится лучше благодаря учащимся, таким как вы! Будь то исправление опечатки, предложение более ясного объяснения или добавление нового примера, ваш вклад помогает другим новичкам добиться успеха.

Благодарим Microsoft Valued Professional Shivam Goyal за предоставленные пример кода.

Процесс внесения вклада организован дружелюбно и поддерживающе. Большинство вкладов требует соглашения о лицензии участника (CLA), но автоматические инструменты помогут вам пройти этот процесс без проблем.

📜 Открытое обучение с открытым исходным кодом

Вся эта учебная программа доступна под лицензией MIT LICENSE, что означает, что вы можете свободно использовать, изменять и распространять её. Это поддерживает нашу миссию по обеспечению доступа к знаниям MCP для разработчиков по всему миру.

🤝 Руководство по внесению вкладов

Этот проект приветствует вклады и предложения. Большинство вкладов требуют согласия с Contributor License Agreement (CLA), подтверждающим, что вы имеете право и действительно предоставляете нам права на использование вашего вклада. Подробности — по адресу https://cla.opensource.microsoft.com.

При создании pull request бот CLA автоматически определит, требуется ли от вас подписание CLA, и отметит PR соответствующим образом (например, проверка статуса, комментарий). Просто следуйте инструкциям, предоставленным ботом. Вам нужно будет сделать это только один раз для всех репозиториев, использующих наш CLA.

Этот проект принял Кодекс поведения Microsoft Open Source. Для дополнительной информации смотрите FAQ по Кодексу поведения или пишите на opencode@microsoft.com с любыми дополнительными вопросами или предложениями.


Готовы начать своё путешествие с MCP? Начните с Модуля 00 - Введение в MCP и сделайте первые шаги в мире разработки с Model Context Protocol!

🎒 Другие курсы

Наша команда выпускает и другие курсы! Ознакомьтесь:

LangChain

LangChain4j для начинающих LangChain.js для начинающих LangChain для начинающих

Azure / Edge / MCP / Агенты

AZD для начинающих Edge AI для начинающих MCP для начинающих AI Agents для начинающих


Серия Генеративного ИИ

Генеративный ИИ для начинающих Генеративный ИИ (.NET) Генеративный ИИ (Java) Генеративный ИИ (JavaScript)


Основное обучение

Машинное обучение для начинающих Наука о данных для начинающих ИИ для начинающих Кибербезопасность для начинающих Веб-разработка для начинающих IoT для начинающих Разработка XR для начинающих


Серия Copilot

Copilot для парного программирования с ИИ Copilot для C#/.NET Приключения Copilot


Отказ от ответственности: Этот документ был переведен с использованием сервиса машинного перевода Co-op Translator. Несмотря на наши усилия по обеспечению точности, имейте в виду, что автоматический перевод может содержать ошибки или неточности. Оригинальный документ на его исходном языке следует считать авторитетным источником. Для получения критически важной информации рекомендуется обратиться к профессиональному человеческому переводу. Мы не несем ответственности за любые недоразумения или неправильные толкования, возникшие в результате использования этого перевода.