Skip to content

Latest commit

 

History

History
102 lines (68 loc) · 6.6 KB

README.md

File metadata and controls

102 lines (68 loc) · 6.6 KB

Começar

Esta secção consiste em várias lições:

  • 1 O teu primeiro servidor, nesta primeira lição, vais aprender a criar o teu primeiro servidor e a inspecioná-lo com a ferramenta de inspeção, uma forma valiosa de testar e depurar o teu servidor, para a lição

  • 2 Cliente, nesta lição, vais aprender a escrever um cliente que pode ligar-se ao teu servidor, para a lição

  • 3 Cliente com LLM, uma forma ainda melhor de escrever um cliente é adicionando um LLM para que possa "negociar" com o teu servidor sobre o que fazer, para a lição

  • 4 Consumir um servidor no modo Agente GitHub Copilot no Visual Studio Code. Aqui, vamos ver como executar o nosso MCP Server a partir do Visual Studio Code, para a lição

  • 5 Consumir a partir de um SSE (Server Sent Events) SSE é um standard para streaming do servidor para o cliente, permitindo que os servidores enviem atualizações em tempo real para os clientes via HTTP para a lição

  • 6 Streaming HTTP com MCP (Streamable HTTP). Aprende sobre streaming HTTP moderno, notificações de progresso, e como implementar servidores e clientes MCP escaláveis e em tempo real usando Streamable HTTP. para a lição

  • 7 Utilizar o AI Toolkit para VSCode para consumir e testar os teus Clientes e Servidores MCP para a lição

  • 8 Testes. Aqui vamos focar especialmente em como podemos testar o nosso servidor e cliente de diferentes formas, para a lição

  • 9 Deployment. Este capítulo vai abordar diferentes formas de fazer o deployment das tuas soluções MCP, para a lição

O Model Context Protocol (MCP) é um protocolo aberto que standardiza a forma como as aplicações fornecem contexto aos LLMs. Pensa no MCP como uma porta USB-C para aplicações de IA – oferece uma forma standard de ligar modelos de IA a diferentes fontes de dados e ferramentas.

Objetivos de Aprendizagem

No final desta lição, serás capaz de:

  • Configurar ambientes de desenvolvimento para MCP em C#, Java, Python, TypeScript e JavaScript
  • Construir e implementar servidores MCP básicos com funcionalidades personalizadas (recursos, prompts e ferramentas)
  • Criar aplicações host que se liguem a servidores MCP
  • Testar e depurar implementações MCP
  • Compreender desafios comuns na configuração e as suas soluções
  • Ligar as tuas implementações MCP a serviços populares de LLM

Configurar o teu Ambiente MCP

Antes de começares a trabalhar com MCP, é importante preparar o teu ambiente de desenvolvimento e compreender o fluxo básico de trabalho. Esta secção vai guiar-te pelos passos iniciais para garantir um arranque tranquilo com MCP.

Pré-requisitos

Antes de mergulhares no desenvolvimento MCP, certifica-te que tens:

  • Ambiente de Desenvolvimento: Para a linguagem escolhida (C#, Java, Python, TypeScript ou JavaScript)
  • IDE/Editor: Visual Studio, Visual Studio Code, IntelliJ, Eclipse, PyCharm ou qualquer editor de código moderno
  • Gestores de Pacotes: NuGet, Maven/Gradle, pip ou npm/yarn
  • Chaves API: Para quaisquer serviços de IA que planeies usar nas tuas aplicações host

SDKs Oficiais

Nos próximos capítulos vais ver soluções construídas usando Python, TypeScript, Java e .NET. Aqui estão todos os SDKs oficialmente suportados.

O MCP fornece SDKs oficiais para várias linguagens:

  • C# SDK - Mantido em colaboração com a Microsoft
  • Java SDK - Mantido em colaboração com a Spring AI
  • TypeScript SDK - A implementação oficial em TypeScript
  • Python SDK - A implementação oficial em Python
  • Kotlin SDK - A implementação oficial em Kotlin
  • Swift SDK - Mantido em colaboração com a Loopwork AI
  • Rust SDK - A implementação oficial em Rust

Principais Conclusões

  • Configurar um ambiente de desenvolvimento MCP é simples com SDKs específicos para cada linguagem
  • Construir servidores MCP envolve criar e registar ferramentas com esquemas claros
  • Clientes MCP ligam-se a servidores e modelos para tirar partido de capacidades alargadas
  • Testar e depurar são essenciais para implementações MCP fiáveis
  • As opções de deployment vão desde desenvolvimento local até soluções baseadas na cloud

Praticar

Temos um conjunto de exemplos que complementa os exercícios que vais encontrar em todos os capítulos desta secção. Além disso, cada capítulo tem também os seus próprios exercícios e tarefas

Recursos Adicionais

O que vem a seguir

Seguinte: Criar o teu primeiro Servidor MCP

Aviso Legal:
Este documento foi traduzido utilizando o serviço de tradução automática Co-op Translator. Embora nos esforcemos pela precisão, por favor tenha em conta que traduções automáticas podem conter erros ou imprecisões. O documento original na sua língua nativa 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 erradas decorrentes da utilização desta tradução.