MCP-for-beginners

Выполните следующие шаги, чтобы начать работу с материалами:

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

🌐 Поддержка нескольких языков

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

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

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

Bash / macOS / Linux:
bash
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):
cmd
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) для начинающих

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

🧠 Обзор учебного курса по Model Context Protocol

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

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

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

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

📚 Структура курса

№	Тема	Концепции	Пример
00	Введение в MCP	Что такое Model Context Protocol, почему MCP важен в AI-пайплайнах	Введение
01	Основные концепции	Подробное изучение ключевых концепций MCP	Основные концепции
02	Безопасность в MCP	Угрозы безопасности и лучшие практики	Безопасность
03	Начало работы с MCP	Настройка среды, создание базовых серверов и клиентов	Начало работы
3.1	Первый сервер	Создание базового сервера с использованием MCP	Первый сервер
3.2	Первый клиент	Создание базового клиента с использованием MCP	Первый клиент
3.3	Клиент с LLM	Создание клиента с использованием MCP совместно с LLM	Клиент с LLM
3.4	Использование сервера в Visual Studio Code	Настройка Visual Studio Code для работы с MCP-сервером	Сервер в VS Code
3.5	Создание сервера с SSE	SSE позволяет открыть сервер для доступа из интернета	Сервер с SSE
3.6	Использование AI Toolkit	AI Toolkit — отличный инструмент для управления AI и MCP	AI Toolkit
3.7	Тестирование сервера	Тестирование — важная часть разработки	Тестирование
3.8	Деплой сервера	Как перейти от локальной разработки к продакшену	Деплой
04	Практическая реализация	Использование SDK на разных языках, отладка, тестирование и валидация	Практика
05	Продвинутые темы MCP	Мультимодальные AI-воркфлоу и расширяемость	Продвинутые темы
5.1	Интеграция MCP с Azure	Демонстрация интеграции с Azure	MCP + Azure
5.2	Мультимодальность	Работа с различными модальностями	Мультимодальность
5.3	MCP OAuth2 Demo	Минимальное Spring Boot-приложение с OAuth2 для MCP	OAuth2 Demo
5.4	Root Contexts	Подробнее о root contexts и их реализации	Root Contexts
5.5	Маршрутизация	Различные типы маршрутизации в MCP	Маршрутизация
5.6	Сэмплирование	Работа с сэмплированием в MCP	Сэмплирование
5.7	Масштабирование	Масштабирование MCP-серверов: горизонтальное и вертикальное, оптимизация ресурсов	Масштабирование
5.8	Безопасность	Углублённая безопасность MCP: аутентификация, авторизация	Безопасность
5.9	MCP Web Search	MCP-сервер и клиент на Python с интеграцией SerpAPI для поиска в реальном времени	Web Search
5.10	Realtime Streaming	Потоковая передача данных в реальном времени — необходимость в современном мире	Streaming
5.11	Realtime Web Search	Поиск в реальном времени: реализация, проблемы и решения	Realtime Search
06	Вклад сообщества	Как вносить код и документацию, сотрудничество через GitHub	Вклад
07	Уроки раннего внедрения	Реальные реализации и что сработало, построение и деплой MCP-решений	Уроки
08	Лучшие практики MCP	Настройка производительности, отказоустойчивость, надёжность	Лучшие практики
09	Кейсы MCP	Глубокий разбор архитектур MCP-решений, шаблоны деплоя и советы по интеграции	Кейсы

Примеры проектов

🧮 Примеры MCP-калькулятора:

Язык	Ссылка
C#	MCP Calculator (C#)
Java	MCP Calculator (Java)
JavaScript	MCP Calculator (JavaScript)
Python	MCP Calculator (Python)
TypeScript	MCP Calculator (TypeScript)

💡 Продвинутые проекты MCP-калькулятора:

Язык	Ссылка
C#	Advanced MCP Calculator (C#)
Java	Advanced MCP Calculator (Java)
JavaScript	Advanced MCP Calculator (JavaScript)
Python	Advanced MCP Calculator (Python)
TypeScript	Advanced MCP Calculator (TypeScript)

🎯 Предварительные требования для изучения MCP

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

Базовые знания C#, Java или Python
Понимание клиент-серверной модели и API
(Опционально) Знакомство с концепциями машинного обучения

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

В этом репозитории есть подробное Руководство по изучению, которое поможет вам эффективно ориентироваться в материалах. Руководство включает:

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

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

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

Чёткие объяснения концепций MCP
Живые примеры кода на нескольких языках
Упражнения для создания реальных MCP-приложений
Дополнительные ресурсы для продвинутых учащихся

📜 Информация о лицензии

Этот контент распространяется под лицензией MIT. Условия использования см. в файле 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 с любыми дополнительными вопросами.

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

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

™️ Уведомление о товарных знаках

Этот проект может содержать товарные знаки или логотипы проектов, продуктов или сервисов. Авторизованное использование товарных знаков или логотипов Microsoft регулируется Правилами использования товарных знаков и брендов Microsoft. Использование товарных знаков или логотипов Microsoft в изменённых версиях этого проекта не должно вводить в заблуждение или подразумевать спонсорство со стороны Microsoft. Любое использование товарных знаков или логотипов третьих сторон регулируется политиками этих третьих сторон.

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

Подключение

README