MCP-для-початківців

Дотримуйтесь цих кроків, щоб почати використовувати ці ресурси:

Форкніть репозиторій: Натисніть
Клонування репозиторію: git clone https://github.com/microsoft/mcp-for-beginners.git
Приєднайтеся до Discord Azure AI Foundry та зустріньтеся з експертами та іншими розробниками

🌐 Підтримка багатомовності

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

🚀 Навчальна програма протоколу контексту моделі (MCP) для початківців

Вивчайте MCP за допомогою практичних прикладів коду на C#, Java, JavaScript, Rust, Python та TypeScript

🧠 Огляд навчальної програми протоколу контексту моделі

Model Context Protocol (MCP) — це передова структура, розроблена для стандартизації взаємодії між AI-моделями та клієнтськими додатками. Ця навчальна програма з відкритим кодом пропонує структурований шлях навчання, який включає практичні приклади коду та реальні випадки використання, на основі популярних мов програмування, таких як C#, Java, JavaScript, TypeScript та Python.

Незалежно від того, чи ви розробник AI, системний архітектор або програміст, цей посібник стане вашим комплексним ресурсом для освоєння основ MCP та стратегій його впровадження.

🔗 Офіційні ресурси MCP

📘 Документація MCP – Детальні навчальні матеріали та посібники користувача
📜 Специфікація MCP – Архітектура протоколу та технічні посилання
📜 Оригінальна специфікація MCP – Технічні посилання на попередню версію (може містити додаткові деталі)
🧑‍💻 Репозиторій MCP на GitHub – SDK, інструменти та приклади коду з відкритим кодом
🌐 Спільнота MCP – Приєднуйтесь до обговорень та робіть внесок у спільноту

🧭 Огляд навчальної програми 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 Streaming	Реалізація HTTP-стрімінгу в MCP	Посібник
3.7	AI Toolkit	Використання AI Toolkit з MCP	Посібник
3.8	Тестування	Тестування реалізації вашого сервера MCP	Посібник
3.9	Розгортання	Розгортання серверів MCP у продакшн	Посібник
3.10	Розширене використання серверів	Використання розширених серверів для покращення функціоналу та архітектури	Посібник
3.11	Простий авторизація	Розділ, що демонструє авторизацію з самого початку та RBAC	Посібник
Модулі 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	Інженерія контексту	Техніки ефективної інженерії контексту	Посібник
5.15	Кастомний транспорт 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-калькуляторів

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

Розширені реалізації MCP

Мова	Опис	Посилання
C#	Розширений зразок	Переглянути код
Java з Spring	Приклад додатку в контейнері	Переглянути код
JavaScript	Розширений зразок	Переглянути код
Python	Складна реалізація	Переглянути код
TypeScript	Зразок для контейнера	Переглянути код

🎯 Передумови для вивчення MCP

Щоб отримати максимальну користь від цього курсу, вам слід мати:

Базові знання програмування хоча б однією з наступних мов: C#, Java, JavaScript, Python або TypeScript
Розуміння моделі клієнт-сервер та API
Знайомство з концепціями REST та HTTP
(Необов’язково) Основи AI/ML
Приєднання до наших обговорень у спільноті для підтримки

📚 Навчальний посібник та ресурси

Цей репозиторій містить кілька ресурсів, які допоможуть вам ефективно навчатися:

Навчальний посібник

Детальний Навчальний посібник доступний для того, щоб допомогти вам ефективно орієнтуватися в цьому репозиторії. Посібник включає:

Візуальну карту навчальної програми з усіма охопленими темами
Детальний розподіл кожного розділу репозиторію
Рекомендації щодо використання зразкових проєктів
Рекомендовані навчальні шляхи для різних рівнів навичок
Додаткові ресурси для доповнення вашого навчання

Журнал змін

Ми ведемо детальний Журнал змін, який відстежує всі значні оновлення навчальних матеріалів, включаючи:

Додавання нового контенту
Структурні зміни
Покращення функцій
Оновлення документації

🛠️ Як ефективно використовувати цей курс

Кожен урок у цьому посібнику включає:

Чіткі пояснення концепцій MCP
Живі приклади коду на кількох мовах
Вправи для створення реальних додатків MCP
Додаткові ресурси для просунутих учнів

Події

MCP Dev Days липень 2025

➡️Дивитися на вимогу - MCP Dev Days

Готуйтеся до двох днів глибокого технічного занурення, спілкування зі спільнотою та практичного навчання на MCP Dev Days — віртуальному заході, присвяченому Model Context Protocol (MCP), новому стандарту, який об’єднує AI-моделі та інструменти, на які вони спираються. Ви можете переглянути MCP Dev Days, зареєструвавшись на нашій сторінці заходу: https://aka.ms/mcpdevdays.

День 1: Продуктивність MCP, DevTools та спільнота:

Присвячений наданню можливостей розробникам використовувати MCP у своєму робочому процесі та святкуванню дивовижної спільноти MCP. Ми будемо разом із членами спільноти та партнерами, такими як Arcade, Block, Okta та Neon, щоб побачити, як вони співпрацюють з Microsoft для формування відкритої, розширюваної екосистеми MCP. Реальні демонстрації у VS Code, Visual Studio, GitHub Copilot та популярних інструментах спільноти Практичні, контекстно-орієнтовані робочі процеси розробки Сесії, очолювані спільнотою, та інсайти Незалежно від того, чи ви тільки починаєте працювати з MCP, чи вже створюєте з ним, День 1 стане джерелом натхнення та практичних висновків.

День 2: Створюйте сервери MCP з упевненістю

Призначений для розробників MCP. Ми глибоко зануримося в стратегії реалізації та найкращі практики створення серверів MCP та інтеграції MCP у ваші AI-робочі процеси.

Теми включають:

Створення серверів MCP та їх інтеграція в агентські середовища
Розробка, керована запитами
Найкращі практики безпеки
Використання будівельних блоків, таких як Functions, ACA та API Management
Вирівнювання реєстрів та інструменти (1P + 3P)

Якщо ви розробник, творець інструментів або стратег AI-продуктів, цей день наповнений інсайтами, які допоможуть вам створювати масштабовані, безпечні та готові до майбутнього рішення MCP.

MCP Boot Camp серпень 2025

Навчайтеся на інтенсивних відеосесіях, як створювати сервери MCP, інтегрувати з VS Code та професійно розгортати на Azure, базуючись на матеріалах курсу MCP для початківців. Отримайте практичні навички в технології, яку вже використовують великі компанії.

➡️Дивитися на вимогу MCP Bootcamp | Англійська

➡️Дивитися на вимогу MCP Bootcamp | Бразилія

➡️Дивитися на вимогу MCP Bootcamp | Іспанська

Вчимо MCP з C# - Серія навчальних посібників

Давайте дізнаємося про Model Context Protocol (MCP), передову структуру, розроблену для стандартизації взаємодії між AI-моделями та клієнтськими додатками. У цьому дружньому для початківців сеансі ми познайомимо вас з 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

🌟 Подяка спільноті

Дякуємо Microsoft Valued Professional Шиваму Гойалу за внесок важливих зразків коду.

📜 Інформація про ліцензію

Цей контент ліцензований під 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-11): Основний контент, організований в одинадцять послідовних модулів, включаючи комплексні лабораторії інтеграції баз даних
11-MCPServerHandsOnLabs/: Повний навчальний шлях з 13 лабораторій для створення готових до продакшну серверів MCP з інтеграцією PostgreSQL
images/: Діаграми та ілюстрації, використані в навчальній програмі
translations/: Підтримка багатомовності з автоматизованими перекладами
translated_images/: Локалізовані версії діаграм та ілюстрацій
study_guide.md: Комплексний посібник для навігації по репозиторію
changelog.md: Запис всіх значних змін у навчальних матеріалах
mcp.json: Файл конфігурації для специфікації MCP
CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Документи управління проєктом

🎒 Інші курси

Наша команда створює інші курси! Ознайомтеся:

™️ Повідомлення про торговельну марку

Цей проєкт може містити торговельні марки або логотипи проєктів, продуктів чи послуг. Дозволене використання торговельних марок або логотипів Microsoft має відповідати
Керівництву Microsoft щодо торговельних марок і брендів.
Використання торговельних марок або логотипів Microsoft у змінених версіях цього проєкту не повинно викликати плутанину або натякати на спонсорство Microsoft.
Будь-яке використання торговельних марок або логотипів третіх сторін має відповідати політикам цих третіх сторін.

Отримання допомоги

Якщо ви зіткнулися з труднощами або маєте запитання щодо створення AI-додатків, приєднуйтесь:

Якщо у вас є відгуки про продукт або виникли помилки під час створення, відвідайте:

Відмова від відповідальності:
Цей документ був перекладений за допомогою сервісу автоматичного перекладу Co-op Translator. Хоча ми прагнемо до точності, будь ласка, майте на увазі, що автоматичні переклади можуть містити помилки або неточності. Оригінальний документ на його рідній мові слід вважати авторитетним джерелом. Для критичної інформації рекомендується професійний людський переклад. Ми не несемо відповідальності за будь-які непорозуміння або неправильні тлумачення, що виникають внаслідок використання цього перекладу.