Añadir una herramienta Hello
Decore una función de Python para que la IA pueda llamarla.
Añadir una herramienta Hello es una lección gratuita de MCP Academy en CoddyKit. Esta es la lección 2 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.
Dote de una capacidad a su servidor
Un servidor sin herramientas no es más que un cascarón. Una herramienta es una función de Python que la IA puede invocar para hacer algo útil para el usuario. 🛠️
El decorador mágico
FastMCP expone una función como herramienta con una sola línea: el decorador @mcp.tool(), colocado justo encima de la definición de la función.
@mcp.tool()
def hello():
...Escriba una función normal
El cuerpo es simplemente Python. No necesita código especial del protocolo ni escribir JSON manualmente. Escriba lo que debe hacer la herramienta y devuelva un valor.
@mcp.tool()
def hello():
return "Hello from MCP!"Añada un parámetro
Las herramientas resultan más útiles cuando reciben datos de entrada. Añada un parámetro y el modelo podrá pasarle un valor cuando decida invocar la herramienta.
@mcp.tool()
def greet(name):
return "Hello, " + nameLas anotaciones de tipo crean el esquema
Añada una anotación de tipo, como name: str, y FastMCP la convertirá en un esquema de entrada. Así, el modelo sabrá exactamente qué tipo de valor debe enviar.
@mcp.tool()
def greet(name: str) -> str:
return "Hello, " + nameEl docstring se convierte en la descripción
El docstring de su función se convierte en la descripción de la herramienta. El modelo lo lee para decidir cuándo es la herramienta adecuada.
@mcp.tool()
def greet(name: str) -> str:
"""Greet a person by name."""
return "Hello, " + nameEl nombre procede de la función
De forma predeterminada, el nombre de la herramienta es el nombre de la función. Por tanto, def greet publica una herramienta que el cliente muestra como "greet".
Devuelva texto sin formato
Para su primera herramienta, simplemente devuelva una cadena. FastMCP la envuelve en el formato de resultado MCP adecuado para que el cliente reciba texto limpio.
Descríbala bien
Una buena redacción es importante: una descripción clara ayuda al modelo a elegir la herramienta en el momento adecuado. Los docstrings imprecisos provocan que se omitan invocaciones.
Se registra automáticamente
No necesita llamar personalmente a ninguna función de registro. Al decorarla, la herramienta queda registrada en su instancia de mcp y lista para anunciarse.
Añada tantas como quiera
Un servidor puede contener muchas herramientas. Solo tiene que decorar cada función y todas aparecerán juntas cuando un cliente pregunte qué hay disponible.
Comprobación rápida
¿De dónde procede la descripción de una herramienta?
Resumen
Ha añadido una herramienta con @mcp.tool(), le ha proporcionado parámetros tipados y ha dejado que el docstring la describa. Su servidor por fin puede hacer algo. ¡Ahora vamos a ejecutarlo! ✨
Aprende Python con un tutor de IA — gratis
Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.
- Cursos
- 30
- Lecciones
- 120
Preguntas frecuentes
¿La lección «Añadir una herramienta Hello» es gratis?
Sí — el texto completo de «Añadir una herramienta Hello» 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 «Añadir una herramienta Hello»?
Decore una función de Python para que la IA pueda llamarla. 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 2 de 4.
¿Cuánto tiempo toma la lección «Añadir una herramienta Hello»?
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
- Crear una instancia de FastMCP
- Añadir una herramienta Hello
- Ejecutar el servidor con stdio
- Confirmar que carga y muestra las herramientas