0Pricing
MCP Academy · Lección

Ejecutar el servidor con stdio

Inicie el servidor para que un cliente pueda conectarse localmente.

Ejecutar el servidor con stdio es una lección gratuita de MCP Academy en CoddyKit. Esta es la lección 3 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de MCP Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de MCP Academy incluye 4 lecciones en total.

Partes de esta lección aún no han sido traducidas y se muestran en inglés.

Time to Start It Up

You have a server object and a tool. Now you need to actually run it so a client can connect and use what you built. 🏃

What stdio Means

The simplest transport is stdio: standard input and output. The client launches your script and talks to it through those two streams.

Call run()

Starting the server is one method. Calling mcp.run() hands control to FastMCP, which begins listening for messages right away.

mcp.run()

Choose the Transport

Pass a transport argument to be explicit. For local use you want "stdio", which is also the default when you call run.

mcp.run(transport="stdio")

The Main Guard

Wrap the call in the classic __main__ guard. That way the server starts only when the file is run directly, not when imported.

if __name__ == "__main__":
    mcp.run()

The Whole File

Here is a complete server: import, instance, tool, and run. Just a handful of lines and it speaks MCP.

from mcp.server.fastmcp import FastMCP
mcp = FastMCP("demo")

@mcp.tool()
def hello() -> str:
    return "Hi!"

if __name__ == "__main__":
    mcp.run()

stdout Is Reserved

One golden rule: never print to standard output. That stream carries protocol messages, and stray text will corrupt them.

Log to stderr Instead

Need to debug? Write to stderr, not stdout. The client ignores stderr, so your notes stay out of the protocol stream.

import sys
print("starting up", file=sys.stderr)

The Client Launches You

With stdio, you rarely run the script by hand. The host app starts your process for you using a configured command.

It Waits, Not Loops Idle

After run() the server blocks, waiting for messages. It isn't frozen; it's listening for the next request from the client.

stdio Is Local Only

Remember that stdio works only on the same machine, since it relies on a launched process. Remote servers use HTTP transport instead, which comes later.

Quick Check

Why must you avoid plain print() in a stdio server?

Recap

You ran the server with mcp.run() over stdio, guarded it with __main__, and kept stdout clean. It's live and listening. Let's confirm it works! ✅

Preguntas frecuentes

¿La lección «Ejecutar el servidor con stdio» es gratis?

Sí — el texto completo de «Ejecutar el servidor con stdio» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de MCP Academy, actualiza a CoddyKit PRO. El curso de MCP Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Ejecutar el servidor con stdio»?

Inicie el servidor para que un cliente pueda conectarse localmente. Practicas MCP Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar MCP Academy?

No se requiere experiencia previa. MCP Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 4.

¿Cuánto tiempo toma la lección «Ejecutar el servidor con stdio»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de MCP Academy?

Sí. Cada lección de MCP Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Crear una instancia de FastMCP
  2. Añadir una herramienta Hello
  3. Ejecutar el servidor con stdio
  4. Confirmar que carga y muestra las herramientas
← Volver a MCP Academy