Este guia de estudo oferece uma visão geral da estrutura e do conteúdo do repositório para o currículo "Protocolo de Contexto de Modelo (MCP) para Iniciantes". Use este guia para navegar pelo repositório de forma eficiente e aproveitar ao máximo os recursos disponíveis.
O Protocolo de Contexto de Modelo (MCP) é uma estrutura padronizada para interações entre modelos de IA e aplicações clientes. Inicialmente criado pela Anthropic, o MCP agora é mantido pela comunidade mais ampla do MCP por meio da organização oficial no GitHub. Este repositório oferece um currículo completo com exemplos práticos de código em C#, Java, JavaScript, Python e TypeScript, voltado para desenvolvedores de IA, arquitetos de sistemas e engenheiros de software.
mindmap
root((MCP for Beginners))
00. Introduction
::icon(fa fa-book)
(Protocol Overview)
(Standardization Benefits)
(Real-world Use Cases)
(AI Integration Fundamentals)
01. Core Concepts
::icon(fa fa-puzzle-piece)
(Client-Server Architecture)
(Protocol Components)
(Messaging Patterns)
(Transport Mechanisms)
02. Security
::icon(fa fa-shield)
(AI-Specific Threats)
(Best Practices 2025)
(Azure Content Safety)
(Auth & Authorization)
(Microsoft Prompt Shields)
03. Getting Started
::icon(fa fa-rocket)
(First Server Implementation)
(Client Development)
(LLM Client Integration)
(VS Code Extensions)
(SSE Server Setup)
(HTTP Streaming)
(AI Toolkit Integration)
(Testing Frameworks)
(Deployment Strategies)
04. Practical Implementation
::icon(fa fa-code)
(Multi-Language SDKs)
(Testing & Debugging)
(Prompt Templates)
(Sample Projects)
(Production Patterns)
05. Advanced Topics
::icon(fa fa-graduation-cap)
(Context Engineering)
(Foundry Agent Integration)
(Multi-modal AI Workflows)
(OAuth2 Authentication)
(Real-time Search)
(Streaming Protocols)
(Root Contexts)
(Routing Strategies)
(Sampling Techniques)
(Scaling Solutions)
(Security Hardening)
(Entra ID Integration)
(Web Search MCP)
06. Community
::icon(fa fa-users)
(Code Contributions)
(Documentation)
(MCP Client Ecosystem)
(MCP Server Registry)
(Image Generation Tools)
(GitHub Collaboration)
07. Early Adoption
::icon(fa fa-lightbulb)
(Production Deployments)
(Microsoft MCP Servers)
(Azure MCP Service)
(Enterprise Case Studies)
(Future Roadmap)
08. Best Practices
::icon(fa fa-check)
(Performance Optimization)
(Fault Tolerance)
(System Resilience)
(Monitoring & Observability)
09. Case Studies
::icon(fa fa-file-text)
(Azure API Management)
(AI Travel Agent)
(Azure DevOps Integration)
(Documentation MCP)
(Real-world Implementations)
10. Hands-on Workshop
::icon(fa fa-laptop)
(MCP Server Fundamentals)
(Advanced Development)
(AI Toolkit Integration)
(Production Deployment)
(4-Lab Structure)
O repositório está organizado em dez seções principais, cada uma focada em diferentes aspectos do MCP:
-
Introdução (00-Introduction/)
- Visão geral do Protocolo de Contexto de Modelo
- Por que a padronização é importante em pipelines de IA
- Casos de uso práticos e benefícios
-
Conceitos Básicos (01-CoreConcepts/)
- Arquitetura cliente-servidor
- Componentes principais do protocolo
- Padrões de mensagens no MCP
-
Segurança (02-Security/)
- Ameaças de segurança em sistemas baseados em MCP
- Melhores práticas para proteger implementações
- Estratégias de autenticação e autorização
- Documentação Completa de Segurança:
- Melhores Práticas de Segurança MCP 2025
- Guia de Implementação de Segurança de Conteúdo Azure
- Controles e Técnicas de Segurança MCP
- Referência Rápida de Melhores Práticas MCP
- Principais Tópicos de Segurança:
- Ataques de injeção de prompt e envenenamento de ferramentas
- Sequestro de sessão e problemas de delegado confuso
- Vulnerabilidades de passagem de token
- Permissões excessivas e controle de acesso
- Segurança da cadeia de suprimentos para componentes de IA
- Integração com Microsoft Prompt Shields
-
Primeiros Passos (03-GettingStarted/)
- Configuração e preparação do ambiente
- Criação de servidores e clientes MCP básicos
- Integração com aplicações existentes
- Inclui seções para:
- Primeira implementação de servidor
- Desenvolvimento de cliente
- Integração com cliente LLM
- Integração com VS Code
- Servidor Server-Sent Events (SSE)
- Streaming HTTP
- Integração com AI Toolkit
- Estratégias de testes
- Diretrizes de implantação
-
Implementação Prática (04-PracticalImplementation/)
- Uso de SDKs em diferentes linguagens de programação
- Técnicas de depuração, testes e validação
- Criação de templates de prompt reutilizáveis e fluxos de trabalho
- Projetos de exemplo com exemplos de implementação
-
Tópicos Avançados (05-AdvancedTopics/)
- Técnicas de engenharia de contexto
- Integração com agente Foundry
- Fluxos de trabalho multimodais de IA
- Demonstrações de autenticação OAuth2
- Capacidades de busca em tempo real
- Streaming em tempo real
- Implementação de contextos raiz
- Estratégias de roteamento
- Técnicas de amostragem
- Abordagens de escalabilidade
- Considerações de segurança
- Integração de segurança Entra ID
- Integração com busca na web
-
Contribuições da Comunidade (06-CommunityContributions/)
- Como contribuir com código e documentação
- Colaboração via GitHub
- Melhorias e feedback impulsionados pela comunidade
- Uso de diversos clientes MCP (Claude Desktop, Cline, VSCode)
- Trabalho com servidores MCP populares, incluindo geração de imagens
-
Lições da Adoção Inicial (07-LessonsfromEarlyAdoption/)
- Implementações reais e histórias de sucesso
- Construção e implantação de soluções baseadas em MCP
- Tendências e roadmap futuro
- Guia de Servidores MCP da Microsoft: Guia completo de 10 servidores MCP da Microsoft prontos para produção, incluindo:
- Microsoft Learn Docs MCP Server
- Azure MCP Server (15+ conectores especializados)
- GitHub MCP Server
- Azure DevOps MCP Server
- MarkItDown MCP Server
- SQL Server MCP Server
- Playwright MCP Server
- Dev Box MCP Server
- Azure AI Foundry MCP Server
- Microsoft 365 Agents Toolkit MCP Server
-
Melhores Práticas (08-BestPractices/)
- Ajuste de desempenho e otimização
- Design de sistemas MCP tolerantes a falhas
- Estratégias de testes e resiliência
-
Estudos de Caso (09-CaseStudy/)
- Exemplo de integração com Azure API Management
- Exemplo de implementação para agente de viagens
- Integração Azure DevOps com atualizações do YouTube
- Exemplos de implementação MCP com documentação
- Exemplos detalhados de implementação
-
Workshop Prático (10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/)
- Workshop prático completo combinando MCP com AI Toolkit
- Construção de aplicações inteligentes que conectam modelos de IA com ferramentas do mundo real
- Módulos práticos cobrindo fundamentos, desenvolvimento de servidor customizado e estratégias de implantação em produção
- Estrutura do Lab:
- Lab 1: Fundamentos do Servidor MCP
- Lab 2: Desenvolvimento Avançado de Servidor MCP
- Lab 3: Integração com AI Toolkit
- Lab 4: Implantação e Escalabilidade em Produção
- Abordagem de aprendizado baseada em laboratórios com instruções passo a passo
O repositório inclui recursos de apoio:
- Pasta de Imagens: Contém diagramas e ilustrações usadas ao longo do currículo
- Traduções: Suporte multilíngue com traduções automáticas da documentação
- Recursos Oficiais MCP:
- Aprendizado Sequencial: Siga os capítulos na ordem (00 a 10) para uma experiência de aprendizado estruturada.
- Foco em Linguagem Específica: Se estiver interessado em uma linguagem de programação específica, explore os diretórios de exemplos para implementações na sua linguagem preferida.
- Implementação Prática: Comece pela seção "Primeiros Passos" para configurar seu ambiente e criar seu primeiro servidor e cliente MCP.
- Exploração Avançada: Depois de dominar o básico, mergulhe nos tópicos avançados para expandir seu conhecimento.
- Engajamento com a Comunidade: Participe da comunidade MCP por meio das discussões no GitHub e canais do Discord para se conectar com especialistas e outros desenvolvedores.
O currículo cobre diversos clientes e ferramentas MCP:
-
Clientes Oficiais:
- Visual Studio Code
- MCP no Visual Studio Code
- Claude Desktop
- Claude no VSCode
- Claude API
-
Clientes da Comunidade:
- Cline (baseado em terminal)
- Cursor (editor de código)
- ChatMCP
- Windsurf
-
Ferramentas de Gerenciamento MCP:
- MCP CLI
- MCP Manager
- MCP Linker
- MCP Router
O repositório apresenta vários servidores MCP, incluindo:
-
Servidores Oficiais Microsoft MCP:
- Microsoft Learn Docs MCP Server
- Azure MCP Server (15+ conectores especializados)
- GitHub MCP Server
- Azure DevOps MCP Server
- MarkItDown MCP Server
- SQL Server MCP Server
- Playwright MCP Server
- Dev Box MCP Server
- Azure AI Foundry MCP Server
- Microsoft 365 Agents Toolkit MCP Server
-
Servidores de Referência Oficiais:
- Filesystem
- Fetch
- Memory
- Sequential Thinking
-
Geração de Imagens:
- Azure OpenAI DALL-E 3
- Stable Diffusion WebUI
- Replicate
-
Ferramentas de Desenvolvimento:
- Git MCP
- Terminal Control
- Code Assistant
-
Servidores Especializados:
- Salesforce
- Microsoft Teams
- Jira & Confluence
Este repositório recebe contribuições da comunidade. Veja a seção Contribuições da Comunidade para orientações sobre como contribuir de forma eficaz para o ecossistema MCP.
| Data | Alterações |
|---|---|
| 18 de julho de 2025 | - Atualizada a estrutura do repositório para incluir o Guia de Servidores MCP da Microsoft - Adicionada lista completa de 10 servidores MCP da Microsoft prontos para produção - Seção de Servidores MCP Populares aprimorada com Servidores Oficiais Microsoft MCP - Atualizada a seção de Estudos de Caso com exemplos reais de arquivos - Adicionados detalhes da Estrutura do Lab para o Workshop Prático |
| 16 de julho de 2025 | - Atualizada a estrutura do repositório para refletir o conteúdo atual - Adicionada seção de Clientes e Ferramentas MCP - Adicionada seção de Servidores MCP Populares - Atualizado o Mapa Visual do Currículo com todos os tópicos atuais - Seção de Tópicos Avançados ampliada com todas as áreas especializadas - Estudos de Caso atualizados para refletir exemplos reais - Esclarecida a origem do MCP como criado pela Anthropic |
| 11 de junho de 2025 | - Criação inicial do guia de estudo - Adicionado Mapa Visual do Currículo - Estrutura do repositório delineada - Inclusão de projetos de exemplo e recursos adicionais |
Este guia de estudo foi atualizado em 18 de julho de 2025 e oferece uma visão geral do repositório até essa data. O conteúdo do repositório pode ser atualizado após essa data.
Aviso Legal:
Este documento foi traduzido utilizando o serviço de tradução por IA Co-op Translator. Embora nos esforcemos para garantir a precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.