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)
(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)
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
-
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 e fluxos de trabalho reutilizáveis
- Projetos de exemplo com casos 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
-
Melhores Práticas (08-BestPractices/)
- Otimização e ajuste de desempenho
- Design de sistemas MCP tolerantes a falhas
- Estratégias de testes e resiliência
-
Estudos de Caso (09-CaseStudy/)
- Estudo de caso: integração com Azure API Management
- Estudo de caso: implementação de agente de viagens
- Estudo de caso: integração Azure DevOps com YouTube
- Exemplos de implementação com documentação detalhada
-
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
- Abordagem de aprendizado em laboratório 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 do 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 no Discord para se conectar com especialistas e outros desenvolvedores.
O currículo aborda 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 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 |
|---|---|
| 16 de julho de 2025 | - Atualizada a estrutura do repositório para refletir o conteúdo atual - Adicionada seção Clientes e Ferramentas MCP - Adicionada seção Servidores MCP Populares - Atualizado o Mapa Visual do Currículo com todos os tópicos atuais - Aprimorada a seção Tópicos Avançados com todas as áreas especializadas - Atualizados Estudos de Caso 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 - Estruturado o repositório - Incluídos projetos de exemplo e recursos adicionais |
Este guia de estudo foi atualizado em 16 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.