wehub/microsoft--mcp-for-beginners

Fork 0

Files

T

wehub-resource-sync c275ba2868 chore: import upstream snapshot with attribution

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

51 KiB

Raw Permalink Blame History

Follow these steps to get started using these resources:

Форкніть репозиторій: Click
Клонуйте репозиторій: git clone https://github.com/microsoft/mcp-for-beginners.git
Приєднуйтесь до

🌐 Підтримка кількох мов

Підтримується через 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"
Це дасть вам усе необхідне для проходження курсу з набагато швидшим завантаженням.

🚀 Курикулум 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 дасть вам можливість створювати більш потужні й гнучкі застосунки.

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

До кінця цього шляху ви матимете впевненість у створенні власних MCP серверів, інтеграціях із популярними AI платформами й розумінні, як ця технологія змінює майбутнє розробки 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 побудований так, щоб поступово нарощувати впевненість і навички. Кожна фаза вводить нові концепції, одночасно закріплюючи вже вивчене.

🌱 Фаза основ: розуміння бази (Модулі 0-2)

Тут починається ваша пригода! Ми познайомимо вас з концепціями MCP за допомогою знайомих аналогій та простих прикладів. Ви дізнаєтесь, що таке MCP, навіщо він потрібен і як він вписується у більший світ AI-розробки.

• Модуль 0 - Вступ до MCP: Почнемо з розгляду того, що таке MCP і чому він настільки важливий для сучасних AI-застосунків. Ви побачите реальні приклади MCP у дії та зрозумієте, як він вирішує поширені проблеми розробників.

• Модуль 1 - Пояснення основних понять: Тут ви вивчите ключові будівельні блоки MCP. Ми використаємо багато аналогій і візуальних прикладів, щоб зробити ці концепції природніми та зрозумілими.

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

🔨 Фаза створення: створення перших реалізацій (Модуль 3)

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

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

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

🚀 Етап зростання: Розширені концепції та застосування у реальному світі (Модулі 4-5)

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

Також ви навчитеся масштабувати ваші реалізації 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 хости	Налаштування Claude Desktop, Cursor, Cline та інших MCP хостів	Посібник
3.13	MCP Inspector	Налагодження та тестування MCP серверів за допомогою Inspector	Посібник
3.14	Семплінг	Використання семплінгу для співпраці з клієнтом	Посібник
3.15	MCP додатки	Створення MCP додатків	Посібник
Модулі 4-5: Практичні та розширені теми
04	Практична реалізація	SDK, налагодження, тестування, повторно використовувані шаблони запитів	Детальніше
4.1	Пагінація	Обробка великих наборів результатів за допомогою курсорної пагінації	Посібник
05	Розширені теми MCP	Мульти-модальний AI, масштабування, використання в підприємствах	Детальніше
5.1	Інтеграція Azure	Інтеграція MCP з Azure	Посібник
5.2	Мультимодальність	Робота з кількома модальностями	Посібник
5.3	Демонстрація OAuth2	Реалізація автентифікації OAuth2	Посібник
5.4	Root Contexts	Розуміння та впровадження root контекстів	Посібник
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	Безпека та мультиорендність	Row Level Security, автентифікація та багатокористувацький доступ до даних	Лаб 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	Приклад контейнера	Переглянути код

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

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

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

📚 Посібник для навчання та ресурси

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

Посібник для навчання

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

Посібник включає:

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

Журнал змін

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

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

🛠️ Як ефективно використовувати цю навчальну програму

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

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

Вивчаємо 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

🎓 Ваш шлях у MCP починається

Вітаємо! Ви щойно зробили перший крок у захоплюючій подорожі, що розширить ваші програмні можливості та підключить вас до передових технологій розвитку ШІ.

Що ви вже досягли

Прочитавши це введення, ви вже почали будувати свій базис знань MCP. Ви розумієте, що таке MCP, чому це важливо, і як ця навчальна програма підтримає ваше навчання. Це значне досягнення і початок вашої експертизи в цій важливій технології.

Пригоди попереду

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

Ваша мережа підтримки

Ви приєднуєтеся до спільноти учнів та експертів, які захоплюються MCP і прагнуть допомогти іншим досягти успіху. Чи застрягли ви на завданні з програмування, чи хочете поділитися проривом — спільнота тут, щоб підтримати вашу подорож.

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

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

Готові почати?

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

Ласкаво просимо у світ розробки Model Context Protocol. Давайте разом створимо щось неймовірне!

🤝 Внесок у навчальну спільноту

Ця навчальна програма стає кращою завдяки внескам таких учнів, як ви! Чи ви виправляєте опечатку, пропонуєте більш ясне пояснення або додаєте новий приклад, ваш внесок допомагає іншим новачкам досягати успіху.

Подяка Microsoft Valued Professional Shivam Goyal за внесок у кодові приклади.

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

📜 Відкрите навчання

Уся ця навчальна програма доступна за ліцензією MIT LICENSE, що означає, що ви можете вільно використовувати, змінювати і поширювати її. Це підтримує нашу місію зробити знання про MCP доступними для розробників у всьому світі.

🤝 Керівництво для внесків

Цей проєкт вітає внески та пропозиції. Більшість внесків вимагають від вас погодитися з 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 з будь-якими питаннями чи коментарями.

Готові розпочати свій шлях MCP? Почніть із Модуля 00 – Вступ до MCP та зробіть перші кроки у світі розробки Model Context Protocol!

🎒 Інші курси

Наша команда створює інші курси! Перегляньте:

LangChain

Azure / Edge / MCP / Агентів

Серія про генеративний AI

Основне навчання

Серія Copilot

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

51 KiB Raw Permalink Blame History Unescape Escape