Laboratório do Cartógrafo MCP

[!TIP] Baixe o ZIP do aluno ou copie todo este laboratório para uma pasta não utilizada. Leia a configuração e as etapas opcionais do GitHub primeiro.

Antes de executar qualquer coisa

Item	Contrato
Runtime	Node 24; as integrações ao vivo são separadas
Arquivos para inspecionar	`starter/.mcp.json`, `starter/server.js`, `verify.js`
Diretório do verificador	Raiz do kit extraído: `node verify.js`; de `starter/`: `node ../verify.js`
Estado inicial	Starter inacabado é rejeitado; preserve o diagnóstico
Evidência final	O verificador do protocolo recebe a identidade esperada do servidor, a descoberta read_map e o resultado estruturado de nexus.

Conceito em prática: O cartógrafo lê um reino sintético por meio de um processo local. A anotação de somente leitura descoberta é uma pista; inspecione o código do servidor e os dados retornados em vez de confiar no nome.

Configure e verifique um servidor local e somente leitura do Model Context Protocol.

Isole o exercício

Copie este laboratório para um local descartável e abra seu diretório starter/ como raiz do espaço de trabalho do VS Code. O verificador local lê starter/.mcp.json diretamente. A descoberta do host é uma verificação opcional separada: use o local de configuração compatível com o harness escolhido, não uma suposição de que todos os hosts carregam este arquivo.

Missão

Complete starter/.mcp.json com exatamente um servidor:

nome: map-reader;
tipo: stdio;
comando: node;
argumentos: ["server.js"];
nenhuma variável de ambiente, URL, credencial ou dependência de rede.

O servidor incluído implementa uma troca funcional mínima de MCP:

initialize;
tools/list;
tools/call para a ferramenta somente leitura read_map.

Execute:

node ../verify.js

do diretório starter/. O verificador testa o protocolo, não apenas a forma da configuração.

Execução guiada

Execute o verificador intocado e registre o estado inicial esperado.
Peça uma explicação fundamentada na fonte do código e das verificações relevantes.
Planeje: configure exatamente um servidor leitor de mapa stdio local usando node e server.js. Revise o código do servidor, o transporte e os dados antes de executar o verificador. Não adicione credenciais nem URLs remotas.
Implemente apenas a fatia aprovada e então execute novamente o mesmo verificador.
Altere o argumento configurado para um arquivo diferente e confirme que a validação de configuração falha antes de um resultado de ferramenta ser aceito. Restaure server.js.
Revise o diff e registre a limitação: a verificação direta do protocolo não prova que um harness específico do VS Code descobriu este arquivo. Use a configuração de host compatível apenas neste espaço de trabalho descartável.

Conclusão e redefinição segura

O comportamento exigido e seu caso negativo têm evidência observada.
O resultado distingue a verificação local do comportamento ao vivo do host/runtime.
Nenhuma credencial, arquivo não relacionado ou serviço foi alterado.
A evidência está salva antes de redefinir o starter copiado.

Use uma nova extração para outra tentativa, ou restaure apenas os arquivos nomeados a partir de uma linha de base Git criada nesta cópia. Nunca aplique um comando de redefinição da raiz do currículo a partir de um projeto diferente.

Continue com a aventura e a rubrica.