Projeto final: implemente um servidor MCP stdio
Implemente um servidor stdio e uma ferramenta privada de consulta de chamados.
- 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ção | Resposta |
|---|---|
falta um campo obrigatório em _meta | erro -32602 “Missing required _meta” |
server/discover | supportedVersions: ["2026-07-28"] e capabilities: {"tools": {}} |
tools/list | definição da ferramenta add |
tools/call para add com inteiros a e b | soma em texto, structuredContent: {"sum": …} e isError: false |
tools/call para add com argumentos inválidos | erro de execução com isError: true |
tools/call para ferramenta desconhecida | erro -32602 “Unknown tool: NAME” |
| qualquer outro método | erro -32601 “Method not found” |
Experimente
Até 15 XPExperimente 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 XPAcompanhe 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.
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.
Implemente um servidor MCP stdio
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
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.
Crie uma consulta privada de chamados de suporte
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
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…