Следуйте этим шагам, чтобы начать использовать эти ресурсы:
- Форк Репозитория: Нажмите
- Клонировать Репозиторий:
git clone https://github.com/microsoft/mcp-for-beginners.git - Присоединиться к
Арабский | Бенгальский | Болгарский | Бирманский (Мьянма) | Китайский (упрощенный) | Китайский (традиционный, Гонконг) | Китайский (традиционный, Макао) | Китайский (традиционный, Тайвань) | Хорватский | Чешский | Датский | Нидерландский | Эстонский | Финский | Французский | Немецкий | Греческий | Иврит | Хинди | Венгерский | Индонезийский | Итальянский | Японский | Каннада | Кхмер | Корейский | Литовский | Малайский | Малаялам | Маратхи | Непальский | Нигерийский пиджин | Норвежский | Персидский (фарси) | Польский | Португальский (Бразилия) | Португальский (Португалия) | Пенджаби (гурмукхи) | Румынский | Русский | Сербский (кириллица) | Словацкий | Словенский | Испанский | Свахили | Шведский | Тагальский (филиппинский) | Тамильский | Телугу | Тайский | Турецкий | Украинский | Урду | Вьетнамский
Предпочитаете клонировать локально?
Этот репозиторий содержит более 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"Это даст вам всё необходимое для прохождения курса с значительно более быстрой загрузкой.
Добро пожаловать в ваше путешествие по Model Context Protocol! Если вы когда-либо задавались вопросом, как приложения ИИ взаимодействуют с разными инструментами и сервисами, вы собираетесь узнать элегантное решение, которое меняет то, как разработчики создают интеллектуальные системы.
Думайте об MCP как о универсальном переводчике для приложений ИИ — так же как USB-порты позволяют подключать любое устройство к вашему компьютеру, MCP позволяет моделям ИИ подключаться к любому инструменту или сервису стандартизированным способом. Независимо от того, создаете ли вы свой первый чат-бот или работаете над сложными AI-воркфлоу, понимание MCP даст вам возможность создавать более продвинутые и гибкие приложения.
Этот курс разработан с терпением и заботой о вашем обучении. Мы начнем с простых понятий, которые вы уже понимаете, и постепенно будем наращивать ваш опыт через практику на вашем любимом языке программирования. Каждый шаг содержит понятные пояснения, практические примеры и много поддержки.
К тому моменту, как вы закончите это путешествие, вы будете уверенно создавать собственные MCP серверы, интегрировать их с популярными AI платформами и понимать, как эта технология меняет будущее разработки ИИ. Давайте начнем это захватывающее приключение вместе!
Этот курс соответствует спецификации MCP 2025-11-25 (последний стабильный релиз). Спецификация MCP использует версионирование на основе даты (формат ГГГГ-ММ-ДД), чтобы обеспечить точное отслеживание версий протокола.
Эти ресурсы становятся более ценными по мере вашего роста, но не чувствуйте давления читать всё сразу. Начинайте с тех областей, которые вас интересуют больше всего!
- 📘 Документация MCP – Ваш главный ресурс с пошаговыми учебниками и руководствами пользователя. Документация написана с учетом начинающих, с понятными примерами, за которыми можно следовать в удобном для вас темпе.
- 📜 Спецификация MCP – Подумайте об этом как о вашем полном справочнике. В процессе изучения курса вы будете возвращаться сюда, чтобы находить конкретные детали и изучать продвинутые функции.
- 📜 Версионирование спецификации MCP – Здесь содержится информация об истории версий протокола и о том, как MCP использует версионирование на основе даты (формат ГГГГ-ММ-ДД).
- 🧑💻 Репозиторий MCP на GitHub – Здесь вы найдете SDK, инструменты и примеры кода на нескольких языках программирования. Это сокровищница практических примеров и готовых компонентов.
- 🌐 Сообщество MCP – Присоединяйтесь к другим ученикам и опытным разработчикам в обсуждениях MCP. Это поддерживающее сообщество, где приветствуются вопросы и свободно делятся знаниями.
По окончании этого курса вы будете чувствовать себя уверенно и вдохновленно новыми навыками. Вот чего вы достигнете:
• Поймете основы MCP: Вы узнаете, что такое Model Context Protocol и почему он меняет взаимодействие AI-приложений, с помощью аналогий и понятных примеров.
• Создадите свой первый MCP сервер: Вы разработаете работающий MCP сервер на выбранном вами языке программирования, начиная с простых примеров и постепенно улучшая навыки.
• Подключите AI модели к реальным инструментам: Вы научитесь строить мост между моделями AI и реальными сервисами, расширяя возможности ваших приложений.
• Реализуете лучшие практики безопасности: Вы поймете, как обеспечить безопасность ваших реализаций MCP, защищая и приложения, и пользователей.
• Будете уверенно развертывать проекты: Вы узнаете, как перенести ваши MCP проекты из разработки в продакшн с практическими стратегиями развертывания.
• Присоединитесь к сообществу MCP: Вы станете частью растущего сообщества разработчиков, формирующих будущее разработки AI приложений.
Перед тем, как погрузиться в детали MCP, убедимся, что вы комфортно чувствуете себя с некоторыми базовыми понятиями. Не волнуйтесь, если вы не эксперт — мы объясним всё по ходу!
Думайте о протоколе как о правилах для разговора. Когда вы звоните другу, вы оба знаете, что нужно говорить «привет», говорить по очереди и прощаться «до свидания». Компьютерным программам тоже нужны такие правила для эффективного общения.
MCP — это протокол, набор согласованных правил, которые помогают моделям AI и приложениям вести продуктивные «беседы» с инструментами и сервисами. Так же, как правила помогают людям лучше понимать друг друга, MCP делает взаимодействие AI приложений более надежным и мощным.
Вы уже ежедневно используете отношения клиент-сервер! Когда вы используете веб-браузер (клиент), чтобы зайти на сайт, вы подключаетесь к веб-серверу, который отправляет вам содержимое страницы. Браузер знает, как запрашивать информацию, а сервер — как отвечать.
В MCP отношения похожи: модели AI выступают клиентами, которые запрашивают информацию или действия, а MCP серверы предоставляют эти возможности. Это похоже на помощника (сервер), к которому AI может обратиться с конкретными задачами.
Представьте, если бы каждый производитель автомобилей использовал газовые насосы разной формы — вам нужен был бы адаптер для каждой машины! Стандартизация значит договоренность об общих подходах, чтобы всё работало гладко.
MCP обеспечивает такую стандартизацию для AI приложений. Вместо того, чтобы писать уникальный код для каждой модели AI и каждого инструмента, MCP создаёт универсальный способ общения. Это значит, что разработчики могут создавать инструменты один раз, а они будут работать со многими разными AI системами.
Ваше путешествие в MCP тщательно структурировано, чтобы постепенно нарастить уверенность и навыки. Каждый этап вводит новые концепции и укрепляет уже изученное.
Это начало вашего приключения! Мы познакомим вас с концепциями MCP через знакомые аналогии и простые примеры. Вы поймёте, что такое MCP, зачем он нужен и как вписывается в большой мир разработки AI.
• Модуль 0 - Введение в MCP: Мы начнем с изучения, что такое MCP и почему он так важен для современных AI приложений. Вы увидите реальные примеры MCP в действии и поймете, как он решает распространённые задачи разработчиков.
• Модуль 1 - Основные понятия: Здесь вы изучите ключевые строительные блоки MCP. Мы используем много аналогий и наглядных примеров, чтобы сделать понятия естественными и понятными.
• Модуль 2 - Безопасность в MCP: Безопасность может показаться сложной, но мы покажем вам встроенные в MCP функции защиты и научим лучшим практикам, которые обезопасят ваши приложения с самого начала.
Теперь начинается настоящее веселье! Вы получите практический опыт создания реальных MCP серверов и клиентов. Не переживайте — мы начнем с простого и проведем вас через каждый шаг.
Этот модуль включает несколько практических руководств, которые позволяют вам практиковаться на предпочитаемом языке программирования. Вы создадите свой первый сервер, разработаете клиента для подключения к нему и даже интегрируетесь с популярными инструментами разработки, такими как VS Code.
Каждое руководство содержит полный пример кода, советы по устранению неполадок и объяснения, почему мы делаем определенные проектные решения. К концу этого этапа у вас будут рабочие реализации MCP, которыми вы сможете гордиться!
Освоив основы, вы готовы изучить более сложные функции MCP. Мы рассмотрим практические стратегии реализации, техники отладки и продвинутые темы, такие как интеграция мультимодальных ИИ.
Вы также узнаете, как масштабировать свои реализации MCP для использования в производстве и интегрироваться с облачными платформами, такими как Azure. Эти модули подготовят вас к созданию MCP решений, способных справляться с реальными задачами.
Последний этап сосредоточен на присоединении к сообществу 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 | AI Toolkit | Использование AI 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 | Sampling | Использование sampling для взаимодействия с клиентом | Руководство |
| 3.15 | MCP приложения | Создание 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 | Sampling | Техники сэмплинга в 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 | Реализация пользовательских транспортов | Руководство |
| 5.16 | Особенности протокола | Уведомления о прогрессе, отмена, шаблоны ресурсов | Руководство |
| 5.17 | Адвeрсариальное мультиагентное рассуждение | Два агента спорят противоположные стороны, используя общие 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 — это постепенное развитие ваших навыков программирования. Мы разработали наши примеры кода так, чтобы начать с простого и постепенно усложнять по мере углубления понимания. Вот как мы вводим концепции — с кодом, который легко понять, но который демонстрирует реальные принципы MCP; вы поймете не только что делает этот код, но и почему он построен именно так и как он вписывается в более крупные MCP приложения.
| Язык | Описание | Ссылка |
|---|---|---|
| C# | Пример MCP сервера | Просмотреть код |
| Java | MCP калькулятор | Просмотреть код |
| JavaScript | Демонстрация MCP | Просмотреть код |
| Python | MCP сервер | Просмотреть код |
| TypeScript | Пример MCP | Просмотреть код |
| Rust | Пример MCP | Просмотреть код |
| Язык | Описание | Ссылка |
|---|---|---|
| C# | Продвинутый пример | Просмотреть код |
| Java с Spring | Пример Container App | Просмотреть код |
| JavaScript | Продвинутый пример | Просмотреть код |
| Python | Сложная реализация | Просмотреть код |
| TypeScript | Образец контейнера | Посмотреть код |
Чтобы получить максимальную отдачу от этой учебной программы, вы должны иметь:
-
Базовые знания программирования хотя бы на одном из следующих языков: C#, Java, JavaScript, Python или TypeScript
-
Понимание модели клиент-сервер и API
-
Знакомство с концепциями REST и HTTP
-
(Опционально) Знания в области AI/ML
-
Присоединение к нашим сообществам для поддержки
В этом репозитории содержится несколько ресурсов, которые помогут вам эффективно ориентироваться и учиться:
Доступно подробное Учебное руководство, которое помогает эффективно ориентироваться в этом репозитории. Эта визуальная карта учебной программы показывает, как связаны все темы, и дает рекомендации по эффективному использованию образцов проектов. Оно особенно полезно тем, кто лучше воспринимает информацию визуально и любит видеть общую картину.
В руководство входит:
- Визуальная карта учебной программы со всеми охватываемыми темами
- Подробный разбор каждого раздела репозитория
- Рекомендации по использованию образцов проектов
- Рекомендуемые пути обучения для разных уровней навыков
- Дополнительные ресурсы для углубленного изучения
Мы ведем подробный Журнал изменений, в котором фиксируются все значительные обновления материалов курса, чтобы вы могли оставаться в курсе последних улучшений и дополнений.
- Добавление нового контента
- Структурные изменения
- Улучшения функций
- Обновления документации
Каждый урок в этом руководстве включает:
- Четкие объяснения концепций MCP
- Примеры кода в реальном времени на нескольких языках
- Упражнения для создания реальных MCP приложений
- Дополнительные ресурсы для продвинутых учеников
Давайте познакомимся с Model Context Protocol (MCP) — современным фреймворком, предназначенным для стандартизации взаимодействий между AI-моделями и клиентскими приложениями. На этом занятии для начинающих мы представим вам MCP и проведем через создание вашего первого MCP-сервера.
JavaScript: https://aka.ms/letslearnmcp-javascript
Поздравляем! Вы сделали первый шаг в захватывающем путешествии, которое расширит ваши навыки программирования и соединит вас с передовыми технологиями разработки AI.
Прочитав это введение, вы уже начали формировать фундамент знаний о MCP. Вы понимаете, что такое MCP, почему это важно и как эта учебная программа поможет вам в обучении. Это значительное достижение и начало вашего становления экспертом в этой важной технологии.
По мере прохождения модулей помните, что каждый эксперт когда-то был новичком. Концепции, которые сейчас могут показаться сложными, со временем станут для вас привычными благодаря практике и применению. Каждый маленький шаг приближает вас к мощным возможностям, которые будут служить вам во всей вашей карьере разработчика.
Вы присоединяетесь к сообществу обучающихся и экспертов, увлеченных MCP и готовых помочь другим добиться успеха. Независимо от того, столкнулись ли вы с проблемами в кодировании или хотите поделиться прорывом, сообщество поддержит вас на пути.
Если вы столкнулись с трудностями или у вас есть вопросы по созданию AI-приложений, присоединяйтесь к обсуждениям с другими обучающимися и опытными разработчиками MCP. Это поддерживающее сообщество, где приветствуются вопросы и свободно обмениваются знаниями.
Если у вас есть отзывы по продукту или ошибки при разработке, посетите:
Ваше приключение с MCP начинается прямо сейчас! Начните с Модуля 0, чтобы погрузиться в первые практические занятия с MCP, или исследуйте образцы проектов, чтобы увидеть, что вы будете создавать. Помните — каждый эксперт начинал ровно там, где вы сейчас, и с терпением и практикой вы удивитесь своим возможностям.
Добро пожаловать в мир разработки Model Context Protocol. Давайте создадим что-то удивительное вместе!
Эта учебная программа становится лучше благодаря вкладу таких учеников, как вы! Будь то исправление опечатки, предложение более ясного объяснения или добавление нового примера, ваши вклады помогают другим новичкам добиться успеха.
Благодарим Microsoft Valued Professional Shivam Goyal за предоставленные образцы кода.
Процесс внесения вкладов сделан гостеприимным и поддерживающим. Большинство вкладов требуют Соглашения о лицензии участника (CLA), но автоматические инструменты помогут вам пройти этот этап без проблем.
Вся эта учебная программа доступна по лицензии MIT LICENSE, что означает, что вы можете свободно использовать, изменять и распространять её. Это поддерживает нашу миссию сделать знания о MCP доступными для разработчиков по всему миру.
Этот проект приветствует ваши вклады и предложения. Большинство вкладов требуют согласия с Соглашением участника (CLA), подтверждающим, что вы имеете право и действительно предоставляете нам права на использование вашего вклада. Подробнее см. на https://cla.opensource.microsoft.com.
При отправке pull request бот CLA автоматически определит, нужно ли вам предоставить CLA, и отметит запрос соответствующим образом (например, проверкой статуса, комментарием). Просто следуйте инструкциям, которые предоставит бот. Вам нужно будет сделать это только один раз для всех репозиториев, использующих наш CLA.
Этот проект принял Кодекс поведения Microsoft Open Source. Подробнее смотрите в Часто задаваемых вопросах по Кодексу поведения или обращайтесь по адресу opencode@microsoft.com с дополнительными вопросами или комментариями.
Готовы начать ваше путешествие в MCP? Начните с Модуля 00 — Введение в MCP и сделайте первые шаги в мире разработки Model Context Protocol!
Наша команда выпускает и другие курсы! Посмотрите:
-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA){kind=icon}
-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC){kind=icon}
-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9){kind=icon}
Отказ от ответственности:
Данный документ был переведен с помощью сервиса автоматического перевода Co-op Translator. Хотя мы стремимся к точности, пожалуйста, имейте в виду, что автоматический перевод может содержать ошибки или неточности. Оригинальный документ на исходном языке следует считать авторитетным источником. Для критически важной информации рекомендуется профессиональный перевод человеком. Мы не несем ответственности за любые недоразумения или неправильные толкования, возникшие в результате использования данного перевода.