Cargando
Cargando

Los prompts en MCP definen un conjunto de mensajes de usuario y asistente que pueden ser utilizados por el cliente. Estos prompts deben ser de alta calidad, estar bien probados y ser relevantes para el propósito general del servidor MCP.

Código del servidor MCP que define un prompt llamado "format" que reescribe el contenido de un documento en formato Markdown.

Implementación de List Prompts

El primer paso es implementar el método list_prompts en tu cliente MCP. Este método recupera todos los prompts disponibles del servidor:

python
async def list_prompts(self) -> list[types.Prompt]:
    result = await self.session().list_prompts()
    return result.prompts

Esta implementación simple llama al método list_prompts de la sesión y devuelve el arreglo de prompts del resultado.

Obtención de prompts individuales

El método get_prompt recupera un prompt específico con argumentos interpolados en él. Cuando solicitas un prompt, proporcionas argumentos que se pasan a la función del prompt como argumentos de palabra clave (keyword arguments):

python
async def get_prompt(self, prompt_name, args: dict[str, str]):
    result = await self.session().get_prompt(prompt_name, args)
    return result.messages

El método devuelve los mensajes del resultado, que forman una conversación que puede introducirse directamente en Claude.

Cómo funcionan los argumentos de los prompts

Cuando defines una función de prompt en el lado del servidor, esta puede aceptar parámetros. Por ejemplo, un prompt de formateo de documentos podría esperar un parámetro doc_id:

python
def format_document(doc_id: str):
    # El doc_id se interpola en el prompt

Cuando el cliente llama a get_prompt, el diccionario de argumentos debe contener las claves esperadas. El servidor MCP pasará estos como argumentos de palabra clave a la función del prompt, permitiendo que se inserte contenido dinámico en la plantilla del prompt.

Prueba de prompts en la CLI

Una vez implementado, puedes probar los prompts a través de la interfaz de línea de comandos. Cuando escribes una barra inclinada, los prompts disponibles aparecen como comandos. Seleccionar un prompt puede pedirte que elijas entre las opciones disponibles (como IDs de documentos), y luego el prompt completo se envía a Claude.

Terminal ejecutando uv run main.py con "/format plan.md" escrito y una lista de autocompletado de archivos con plan.md resaltado.

El flujo de trabajo se ve así:

  1. El usuario selecciona un prompt (como "format")
  2. El sistema solicita los argumentos requeridos (como qué documento formatear)
  3. El prompt se envía a Claude con los valores interpolados
  4. Claude puede entonces usar herramientas para obtener datos adicionales y completar la tarea

Markdown de terminal con una fila de tabla de recursos que dice "Development Team 5 FTE Phases 1-5" y una sección de Risk Management.

Mejores prácticas para prompts

Al crear prompts para tu servidor MCP:

  • Haz que sean relevantes para el propósito de tu servidor
  • Pruébalos a fondo antes de la implementación
  • Usa instrucciones claras y específicas
  • Diséñalos para que funcionen bien con tus herramientas disponibles
  • Considera qué argumentos necesitarán proporcionar los usuarios

Los prompts cierran la brecha entre la funcionalidad predefinida y las necesidades dinámicas de los usuarios, proporcionando a Claude puntos de partida estructurados para tareas complejas mientras mantienen la flexibilidad mediante la parametrización.