Cómo funciona el transporte stdio

Antes de conectar su servidor a cualquier cosa, debe saber cómo se comunica realmente. El canal predeterminado es stdio. 🔌

El nombre stdio simplemente significa entrada estándar más salida estándar: dos flujos de texto que todo programa ya tiene desde el momento en que se inicia.

Con stdio, el host inicia su servidor como un proceso secundario. No hay ningún puerto ni llamada de red, solo un programa local que controla.

El cliente escribe mensajes JSON-RPC en el stdin de su servidor, y el servidor escribe sus respuestas de vuelta a través de stdout.

Casi nunca inicia el script usted mismo. Indica al host un comando, y este ejecuta dicho comando para poner en marcha su servidor.

Como las respuestas viajan por stdout, ese flujo está reservado para el protocolo. Cualquier print adicional allí desordenará el JSON que espera el cliente.

¿Necesita dejarse notas? Envíelas a stderr. El host trata stderr como registros, por lo que la depuración nunca afecta al flujo de mensajes.

Cada conexión stdio es un enlace privado: un cliente y un proceso. Cierre el cliente y el proceso de su servidor se cerrará con él.

stdio destaca para el trabajo local. No necesita autenticación, firewall ni URL, lo que lo convierte en el transporte perfecto mientras desarrolla. 💻

La desventaja es que el servidor debe estar en la misma máquina que el host. Para acceder a un servidor remotamente, más adelante cambiará al transporte HTTP.

Cada mensaje JSON-RPC es una sola línea que termina en un salto de línea. Este encuadre permite a ambos lados dividir el flujo en mensajes independientes y ordenados.

Ha visto cómo funciona stdio: el host inicia su proceso, se comunica mediante stdin y stdout, y mantiene los registros en stderr. Ahora vamos a conectarlo a Claude. ✅