Это руководство по изучению предоставляет обзор структуры и содержимого репозитория для учебной программы «Протокол Контекста Модели (MCP) для начинающих». Используйте его, чтобы эффективно ориентироваться в репозитории и максимально использовать доступные ресурсы.
Протокол Контекста Модели (MCP) — это стандартизированная платформа для взаимодействия между ИИ-моделями и клиентскими приложениями. Изначально созданный компанией Anthropic, MCP теперь поддерживается более широкой сообществом MCP через официальную организацию на GitHub. В этом репозитории представлена комплексная учебная программа с практическими примерами кода на C#, Java, JavaScript, Python и TypeScript, предназначенная для разработчиков ИИ, системных архитекторов и инженеров-программистов.
mindmap
root((MCP for Beginners))
00. Introduction
::icon(fa fa-book)
(Protocol Overview)
(Standardization)
(Use Cases)
01. Core Concepts
::icon(fa fa-puzzle-piece)
(Client-Server Architecture)
(Protocol Components)
(Messaging Patterns)
02. Security
::icon(fa fa-shield)
(Threat Models)
(Best Practices)
(Auth Strategies)
03. Getting Started
::icon(fa fa-rocket)
(First Server)
(Client)
(LLM Client)
(VS Code Integration)
(SSE Server)
(HTTP Streaming)
(AI Toolkit)
(Testing)
(Deployment)
04. Practical Implementation
::icon(fa fa-code)
(SDKs)
(Testing/Debugging)
(Prompt Templates)
(Sample Projects)
05. Advanced Topics
::icon(fa fa-graduation-cap)
(Context Engineering)
(Foundry Integration)
(Multi-modal AI)
(OAuth2 Demo)
(Real-time Search)
(Streaming)
(Root Contexts)
(Routing)
(Sampling)
(Scaling)
(Security)
(Entra ID)
(Web Search)
06. Community
::icon(fa fa-users)
(Code Contributions)
(Documentation)
(MCP Clients)
(MCP Servers)
(Image Generation)
07. Early Adoption
::icon(fa fa-lightbulb)
(Real-world Examples)
(Deployment Stories)
(Future Roadmap)
08. Best Practices
::icon(fa fa-check)
(Performance)
(Fault Tolerance)
(Resilience)
09. Case Studies
::icon(fa fa-file-text)
(API Management)
(Travel Agent)
(Azure DevOps)
(Documentation MCP)
10. Hands-on Workshop
::icon(fa fa-laptop)
(AI Toolkit Integration)
(Custom Server Development)
(Production Deployment)
Репозиторий организован в десять основных разделов, каждый из которых посвящён разным аспектам MCP:
-
Введение (00-Introduction/)
- Обзор Протокола Контекста Модели
- Почему стандартизация важна в ИИ-пайплайнах
- Практические примеры использования и преимущества
-
Основные концепции (01-CoreConcepts/)
- Клиент-серверная архитектура
- Ключевые компоненты протокола
- Паттерны обмена сообщениями в MCP
-
Безопасность (02-Security/)
- Угрозы безопасности в системах на базе MCP
- Лучшие практики по обеспечению безопасности реализации
- Стратегии аутентификации и авторизации
-
Начало работы (03-GettingStarted/)
- Настройка и конфигурация окружения
- Создание базовых MCP-серверов и клиентов
- Интеграция с существующими приложениями
- Включает разделы:
- Первая реализация сервера
- Разработка клиента
- Интеграция LLM клиента
- Интеграция с VS Code
- Сервер Server-Sent Events (SSE)
- HTTP-стриминг
- Интеграция AI Toolkit
- Стратегии тестирования
- Руководство по развертыванию
-
Практическая реализация (04-PracticalImplementation/)
- Использование SDK на разных языках программирования
- Отладка, тестирование и методы валидации
- Создание переиспользуемых шаблонов запросов и рабочих процессов
- Примеры проектов с реализациями
-
Продвинутые темы (05-AdvancedTopics/)
- Техники инженерии контекста
- Интеграция агента Foundry
- Мультимодальные ИИ-рабочие процессы
- Демонстрации аутентификации OAuth2
- Возможности поиска в реальном времени
- Потоковая передача данных в реальном времени
- Реализация корневых контекстов
- Стратегии маршрутизации
- Методы сэмплирования
- Подходы к масштабированию
- Вопросы безопасности
- Интеграция безопасности Entra ID
- Интеграция веб-поиска
-
Вклад сообщества (06-CommunityContributions/)
- Как вносить код и документацию
- Совместная работа через GitHub
- Улучшения и обратная связь от сообщества
- Использование различных MCP клиентов (Claude Desktop, Cline, VSCode)
- Работа с популярными MCP серверами, включая генерацию изображений
-
Уроки раннего внедрения (07-LessonsfromEarlyAdoption/)
- Реальные реализации и истории успеха
- Создание и развертывание решений на базе MCP
- Тенденции и планы на будущее
-
Лучшие практики (08-BestPractices/)
- Оптимизация производительности и настройка
- Проектирование отказоустойчивых MCP-систем
- Стратегии тестирования и устойчивости
-
Кейсы (09-CaseStudy/)
- Кейсы: интеграция с Azure API Management
- Кейсы: реализация для туристического агента
- Кейсы: интеграция Azure DevOps с YouTube
- Примеры реализации с подробной документацией
-
Практический семинар (10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/)
- Всеобъемлющий практический семинар по объединению MCP с AI Toolkit
- Создание интеллектуальных приложений, связывающих ИИ-модели с реальными инструментами
- Практические модули, охватывающие основы, разработку кастомных серверов и стратегии продакшн-развертывания
- Обучение в лабораторном формате с пошаговыми инструкциями
Репозиторий включает вспомогательные материалы:
- Папка Images: содержит диаграммы и иллюстрации, используемые в учебной программе
- Переводы: поддержка нескольких языков с автоматическим переводом документации
- Официальные ресурсы MCP:
- Последовательное обучение: изучайте главы по порядку (с 00 по 10) для структурированного освоения материала.
- Фокус на конкретном языке: если вас интересует определённый язык программирования, изучайте каталоги с примерами для выбранного языка.
- Практическая реализация: начните с раздела «Начало работы», чтобы настроить окружение и создать первый MCP-сервер и клиента.
- Продвинутое изучение: освоив основы, переходите к продвинутым темам для расширения знаний.
- Вовлечение сообщества: присоединяйтесь к сообществу MCP через обсуждения на GitHub и каналы Discord, чтобы общаться с экспертами и коллегами-разработчиками.
Учебная программа охватывает различные MCP клиенты и инструменты:
-
Официальные клиенты:
- Visual Studio Code
- MCP в Visual Studio Code
- Claude Desktop
- Claude в VSCode
- Claude API
-
Клиенты сообщества:
- Cline (терминальный клиент)
- Cursor (редактор кода)
- ChatMCP
- Windsurf
-
Инструменты управления MCP:
- MCP CLI
- MCP Manager
- MCP Linker
- MCP Router
В репозитории представлены различные MCP серверы, включая:
-
Официальные эталонные серверы:
- Filesystem
- Fetch
- Memory
- Sequential Thinking
-
Генерация изображений:
- Azure OpenAI DALL-E 3
- Stable Diffusion WebUI
- Replicate
-
Инструменты разработки:
- Git MCP
- Terminal Control
- Code Assistant
-
Специализированные серверы:
- Salesforce
- Microsoft Teams
- Jira & Confluence
Этот репозиторий приветствует вклад сообщества. См. раздел «Вклад сообщества» для рекомендаций по эффективному участию в экосистеме MCP.
| Дата | Изменения |
|---|---|
| 16 июля 2025 | - Обновлена структура репозитория в соответствии с текущим содержимым - Добавлен раздел Клиенты и инструменты MCP - Добавлен раздел Популярные MCP серверы - Обновлена визуальная карта учебной программы со всеми актуальными темами - Расширен раздел Продвинутые темы всеми специализированными направлениями - Обновлены кейсы с реальными примерами - Уточнено происхождение MCP как проекта Anthropic |
| 11 июня 2025 | - Первоначальное создание руководства по изучению - Добавлена визуальная карта учебной программы - Описана структура репозитория - Включены примеры проектов и дополнительные ресурсы |
Это руководство по изучению обновлено 16 июля 2025 года и отражает состояние репозитория на эту дату. Содержимое репозитория может обновляться после этой даты.
Отказ от ответственности:
Этот документ был переведен с помощью сервиса автоматического перевода Co-op Translator. Несмотря на наши усилия по обеспечению точности, просим учитывать, что автоматический перевод может содержать ошибки или неточности. Оригинальный документ на его исходном языке следует считать авторитетным источником. Для получения критически важной информации рекомендуется обращаться к профессиональному переводу, выполненному человеком. Мы не несем ответственности за любые недоразумения или неправильные толкования, возникшие в результате использования данного перевода.