Declarar parámetros con indicaciones de tipo
Use las indicaciones de tipo de Python para definir el esquema de la herramienta.
Declarar parámetros con indicaciones de tipo 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.
Los parámetros se convierten en un esquema
Cada argumento de la función de su herramienta se convierte en parte de un esquema de entrada que el modelo debe seguir al llamar a la herramienta. 🧩
Las sugerencias de tipos hacen el trabajo
FastMCP lee las sugerencias de tipos de Python y crea el esquema JSON por usted, así que rara vez tendrá que escribir el esquema manualmente.
@mcp.tool()
def add(a: int, b: int) -> int:
return a + bstr, int, float, bool
Los tipos básicos se asignan directamente: str se convierte en string, int y float en number, y bool en boolean dentro del esquema.
Sin tipo no hay claridad
Si omite la sugerencia de tipo, el modelo solo ve un valor flexible sin reglas, lo que facilita que envíe datos incorrectos o no válidos.
def add(a, b):
return a + bObligatorio de forma predeterminada
Un parámetro sin valor predeterminado se considera obligatorio, por lo que el modelo siempre debe proporcionarlo al llamar a la herramienta.
Los valores predeterminados lo hacen opcional
Asigne un valor predeterminado a un parámetro y se volverá opcional. El modelo puede omitirlo y su función usará el valor alternativo.
@mcp.tool()
def greet(name: str, formal: bool = False) -> str:
...Listas y diccionarios
También puede indicar colecciones. Un argumento de tipo list se asigna a un array JSON, y un dict a un objeto que el modelo puede completar.
def tag(items: list[str]) -> int:
return len(items)Valores opcionales
Use Optional cuando un argumento pueda ser un valor o None. Así indica que el modelo puede dejarlo vacío intencionadamente.
from typing import Optional
def find(q: str, limit: Optional[int] = None):
...Asigne nombres claros a los parámetros
El modelo ve el nombre de cada parámetro en el esquema, así que city es mejor que c y start_date es mejor que arg2. Los nombres claros orientan mejor las llamadas.
Las sugerencias permiten validar
Como las sugerencias definen el esquema, MCP puede rechazar las llamadas con el tipo incorrecto antes de ejecutar su código y detectar los errores a tiempo.
Mantenga pequeña la firma
Al modelo le resulta más fácil completar correctamente pocos parámetros bien tipados que una lista larga de argumentos poco relacionados.
Comprobación rápida
¿Qué hace que un parámetro de herramienta sea opcional en FastMCP?
Repaso
Sus sugerencias de tipos construyen el esquema de la herramienta: los tipos básicos se asignan directamente, los valores predeterminados indican que algo es opcional y los nombres claros orientan al modelo. ✅
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 «Declarar parámetros con indicaciones de tipo» es gratis?
Sí — el texto completo de «Declarar parámetros con indicaciones de tipo» 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 «Declarar parámetros con indicaciones de tipo»?
Use las indicaciones de tipo de Python para definir el esquema de la herramienta. 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 «Declarar parámetros con indicaciones de tipo»?
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
- Nombrar y describir bien una herramienta
- Declarar parámetros con indicaciones de tipo
- Devolver resultados útiles
- Una herramienta de calculadora, de principio a fin