Carregando
0xF0Lição 16 de 16

Projeto final: implemente um servidor MCP stdio

Implemente um servidor stdio e uma ferramenta privada de consulta de chamados.

50 min Questionário com 5 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Ler solicitações JSON-RPC por stdio
  • Implementar descoberta e listagem de ferramentas
  • Validar argumentos e retornar erros e resultados corretos

Agora reúna os conceitos em um servidor MCP mínimo. O programa lê uma mensagem JSON por linha em stdin, valida os metadados da revisão, implementa server/discover, tools/list e tools/call, e escreve exatamente uma resposta JSON por linha em stdout. Use stderr para diagnósticos.

Este exercício implementa o protocolo para aprendizado. Em uma aplicação real, prefira o SDK oficial, que cuida do transporte e dos detalhes de compatibilidade.

Seu servidor deve lidar com:

SolicitaçãoResposta
falta um campo obrigatório em _metaerro -32602 “Missing required _meta”
server/discoversupportedVersions: ["2026-07-28"] e capabilities: {"tools": {}}
tools/listdefinição da ferramenta add
tools/call para add com inteiros a e bsoma em texto, structuredContent: {"sum": …} e isError: false
tools/call para add com argumentos inválidoserro de execução com isError: true
tools/call para ferramenta desconhecidaerro -32602 “Unknown tool: NAME”
qualquer outro métodoerro -32601 “Method not found”

Experimente

Até 15 XP

Experimente a ferramenta add

Antes de programar, experimente o servidor: envie argumentos para add e confira qual resposta cada chamada deve receber. Seu servidor deve produzir os mesmos tipos de resposta.

Definição da ferramenta compartilhada pelo servidor (tools/list)

{
  "name": "add",
  "description": "Soma dois números inteiros.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "a": {
        "type": "integer"
      },
      "b": {
        "type": "integer"
      }
    },
    "required": [
      "a",
      "b"
    ],
    "additionalProperties": false
  }
}

Resposta do servidorSucesso

{
  "jsonrpc": "2.0",
  "id": 7,
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "Some 2 e 3."
      }
    ],
    "isError": false
  }
}

Laboratório aplicado: consulta de chamados

Equipes reais oferecem capacidades específicas e auditáveis, em vez de dar acesso amplo ao banco de dados a um assistente. No próximo exercício, uma ferramenta somente de leitura get_ticket devolve um resultado estruturado apenas quando o chamado pertence ao usuário validado. Ids desconhecidos e não autorizados produzem o mesmo erro, sem revelar a existência de chamados de outras pessoas. O exemplo de quadro de tarefas do SDK oficial de TypeScript mostra o padrão mais amplo: ferramentas alteram estado, recursos o expõem, prompts iniciam fluxos e logs permitem auditoria. Nosso laboratório usa um suporte simulado para testar claramente a fronteira de privacidade.

Experimente

Até 15 XP

Acompanhe uma consulta privada de chamado

Avance pela solicitação. Preveja se o servidor pode revelar o chamado antes de ver cada resultado. Nesta simulação, o servidor já validou a identidade.

Mensagem 1 de 5Previsões 0/0
Host + cliente MCP
Servidor MCP de suporte
Base de chamados

Preveja: O servidor pode confiar em um nome de usuário recebido como argumento da ferramenta?

Principais conclusões

  • Uma linha de entrada corresponde a uma solicitação; uma linha de saída corresponde à resposta.

  • Valide metadados e argumentos antes de executar uma ferramenta.

  • Use o SDK oficial ao transformar o protótipo em uma aplicação real.

Quiz da aula

5 perguntas · aprovação com 4 acertos · até 50 XP

Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.

Pratique: crie um servidor MCP

Escreva código Python no editor e execute os testes com exemplos. O Python roda localmente no navegador usando WebAssembly.

Exercício 1

Implemente um servidor MCP stdio

+25 XP

Complete o servidor em Python para validar metadados, responder a server/discover e tools/list, executar tools/call e retornar erros adequados para métodos desconhecidos e argumentos inválidos. Leia uma solicitação JSON por linha e escreva uma resposta compacta por linha.

  • Descoberta e listagem
  • Chamada válida
  • Argumentos inválidos
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Exercício 2

Crie uma consulta privada de chamados de suporte

+25 XP

Um servidor MCP de suporte oferece a ferramenta somente de leitura get_ticket. O ambiente de exercícios fornece uma linha JSON por solicitação, com verified_user e ticket_id. Nesta simulação, verified_user representa uma identidade já validada pelo servidor. Devolva um resultado de ferramenta MCP. Se o chamado pertencer ao usuário, inclua conteúdo de texto, structuredContent com id, estado e resumo, e isError: false. Para um id desconhecido ou chamado de outra pessoa, devolva o mesmo erro not_available, sem revelar se o chamado existe. Em um servidor HTTP real, obtenha a identidade de um token validado, nunca dos argumentos da ferramenta.

  • O proprietário vê seu chamado
  • Outra pessoa não pode vê-lo
  • Desconhecido e não autorizado são indistinguíveis
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Dúvidas sobre esta lição

Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.

Carregando publicações…