Laboratorio El cartógrafo de MCP
[!TIP] Descarga el ZIP del alumno o copia todo este laboratorio en una carpeta sin usar. Lee la configuración y los pasos opcionales de GitHub primero.
Antes de ejecutar nada
| Elemento | Contrato |
|---|---|
| Runtime | Node 24; las integraciones en vivo son independientes |
| Archivos a revisar | starter/.mcp.json, starter/server.js, verify.js |
| Directorio del verificador | Raíz del kit extraído: node verify.js; desde starter/: node ../verify.js |
| Estado inicial | Se rechaza un starter sin terminar; conserva el diagnóstico |
| Evidencia final | El verificador del protocolo recibe la identidad esperada del servidor, el descubrimiento read_map y el resultado estructurado de nexus. |
Concepto en la práctica: El cartógrafo lee un reino sintético a través de un proceso local. La anotación de solo lectura descubierta es una pista; inspecciona el código del servidor y los datos devueltos en lugar de confiar en su nombre.
Configura y verifica un servidor local y de solo lectura de Model Context Protocol.
Aísla el ejercicio
Copia este laboratorio a una ubicación desechable y abre su directorio starter/ como raíz del espacio de trabajo de VS Code. El verificador local lee starter/.mcp.json directamente. El descubrimiento del host es una comprobación opcional aparte: usa la ubicación de configuración compatible con el harness que elijas, no una suposición de que todos los hosts cargan este archivo.
Misión
Completa starter/.mcp.json con exactamente un servidor:
- name:
map-reader; - type:
stdio; - command:
node; - args:
["server.js"]; - sin variables de entorno, URL, credenciales ni dependencias de red.
El servidor incluido implementa un intercambio MCP mínimo y funcional:
initialize;tools/list;tools/callpara la herramienta de solo lecturaread_map.
Ejecuta:
node ../verify.js
desde el directorio starter/. El verificador pone a prueba el protocolo, no solo la forma de la configuración.
Ejecución guiada
- Ejecuta el verificador sin modificar y registra el estado inicial esperado.
- Pide una explicación fundamentada en las fuentes del código y las comprobaciones relevantes.
- Planifica: configura exactamente un servidor lector de mapas stdio local usando node y server.js. Revisa el código del servidor, el transporte y los datos antes de ejecutar el verificador. No añadas credenciales ni URL remotas.
- Implementa solo el fragmento aprobado y luego vuelve a ejecutar el mismo verificador.
- Cambia el argumento configurado por un archivo distinto y confirma que la validación de configuración falla antes de aceptar un resultado de herramienta. Restaura server.js.
- Revisa el diff y registra la limitación: la comprobación directa del protocolo no demuestra que un harness específico de VS Code haya descubierto este archivo. Usa la configuración de host compatible solo en este espacio de trabajo desechable.
Finalización y restablecimiento seguro
- El comportamiento requerido y su caso negativo cuentan con evidencia observada.
- El resultado distingue la verificación local del comportamiento en vivo del host/runtime.
- No se cambiaron credenciales, archivos no relacionados ni servicios.
- La evidencia está guardada antes de restablecer el starter copiado.
Usa una nueva extracción para otro intento, o restaura solo los archivos nombrados desde una línea base de Git creada en esta copia. Nunca apliques un comando de restablecimiento de la raíz del currículo desde un proyecto ajeno.
Continúa con la aventura y la rúbrica.