Skip to content

Latest commit

 

History

History
264 lines (199 loc) · 27.3 KB

File metadata and controls

264 lines (199 loc) · 27.3 KB

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

GitHub contributors
GitHub issues
GitHub pull-requests
PRs Welcome

GitHub watchers
GitHub forks
GitHub stars

Microsoft Azure AI Foundry Discord

Виконайте наступні кроки, щоб почати використовувати ці ресурси:

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

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

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

Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Korean | Malay | Marathi | Nepali | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Thai | Turkish | Ukrainian | Urdu | Vietnamese

🚀 Навчальний курс Model Context Protocol (MCP) для початківців

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

🧠 Огляд навчального курсу Model Context Protocol

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

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

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

🧭 Огляд навчального курсу MCP

📚 Повна структура курсу

Модуль Тема Опис Посилання
Модулі 1-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 у продакшн Посібник
Модулі 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 Лабораторна робота

💻 Приклади проектів коду

Базові приклади MCP-калькуляторів

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

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

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

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

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

  • Базові знання програмування хоча б однією з наступних мов: C#, Java, JavaScript, Python або TypeScript

  • Розуміння моделі клієнт-сервер та API

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

  • (Опціонально) Основи концепцій AI/ML

  • Участь у наших обговореннях спільноти для підтримки

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

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

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

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

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

Журнал змін

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

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

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

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

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

Події

Готуйтеся до двох днів глибокого технічного занурення, спілкування зі спільнотою та практичного навчання на 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 Boot Camp серпень 2025

Навчайтеся на інтенсивних відеосесіях, як створювати сервери 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: Документи управління проектом

🎒 Інші курси

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

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

Цей проект може містити торговельні марки або логотипи для проектів, продуктів чи послуг. Авторизоване використання торговельних марок або логотипів Microsoft підлягає і повинно відповідати Microsoft's Trademark & Brand Guidelines. Використання торговельних марок або логотипів Microsoft у модифікованих версіях цього проекту не повинно викликати плутанину або припускати спонсорство Microsoft. Будь-яке використання торговельних марок або логотипів третіх сторін підлягає політикам цих третіх сторін.


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