26 minutos de aula prática

1.1 Protocolo MCP em Detalhes: Resources, Tools, Prompts e Transports

Acompanhe o passo a passo detalhado no conteúdo abaixo e execute os códigos em tempo real.

MCP Masters: Construção de Servidores e Ferramentas para Agentes de IA

1.1 Protocolo MCP em Detalhes: Resources, Tools, Prompts e Transports

Duração: 26 minutos • Módulo Prático

Objetivo e Resumo da Aula

Como funciona o handshake e a troca de mensagens JSON-RPC 2.0 no protocolo MCP.

### Arquitetura Profunda do Model Context Protocol O MCP opera sobre **JSON-RPC 2.0**, permitindo que o cliente de IA e o servidor local comuniquem capacidades através de primitivas padronizadas: - **Tools:** Funções executáveis que realizam mutações ou consultas no ambiente. - **Resources:** Dados estáticos ou dinâmicos que funcionam como arquivos virtuais para o contexto do LLM. - **Prompts:** Templates pré-configurados para guiar o usuário em tarefas comuns.

Exemplo de Servidor MCP com Ferramenta Dinâmica

mcp-server.ts

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new Server(
  { name: "analytics-mcp", version: "1.0.0" },
  { capabilities: { tools: {}, resources: {} } }
);

server.setRequestHandler("tools/list", async () => ({
  tools: [
    {
      name: "get_daily_metrics",
      description: "Retorna métricas de tráfego e conversão do dia",
      inputSchema: {
        type: "object",
        properties: {
          period: { type: "string", enum: ["today", "last_7_days"] }
        }
      }
    }
  ]
}));

const transport = new StdioServerTransport();
await server.connect(transport);