Cargando

Configuración del proyecto

Lección 495 min
Cargando

Vamos a construir un chatbot basado en CLI para comprender mejor cómo trabajan juntos los clientes y servidores MCP. Este proyecto práctico te dará experiencia directa con ambos lados de la arquitectura MCP.

Cuando termines la configuración, deberías poder hacer dos cosas: explicar qué hace el cliente y qué hace el servidor, y determinar si una respuesta llegó a través de una herramienta o directamente del modelo.

Qué vamos a construir

Nuestro chatbot permitirá a los usuarios interactuar con una colección de documentos a través de una interfaz de línea de comandos. El sistema consta de dos componentes principales:

  • Un cliente MCP que gestiona las interacciones del usuario
  • Un servidor MCP personalizado que gestiona las operaciones con documentos

Nuestro cliente MCP se comunica en ambas direcciones con nuestro servidor MCP, cuyas herramientas acceden a document.pdf, spreadsheet.xlsx, report.txt y spec.md.

El servidor proporcionará dos herramientas esenciales: una para leer el contenido de los documentos y otra para actualizarlo. Todos los documentos se almacenarán en memoria por simplicidad, sin necesidad de una base de datos.

Nota importante sobre la arquitectura

En proyectos del mundo real, normalmente implementas un cliente MCP o un servidor MCP, no ambos. Podrías crear:

  • Un servidor MCP para exponer tu servicio a otros desarrolladores
  • Un cliente MCP para conectarte a servidores MCP existentes

Nuestro servidor contiene el cliente MCP, que se comunica en ambas direcciones con un servidor MCP independiente.

Estamos construyendo ambos componentes en este proyecto puramente con fines educativos, para entender cómo se comunican y trabajan juntos.

Configuración del proyecto

Descarga cli_project.zip desde la sección de Descargas al final de esta lección y extráelo en tu directorio de desarrollo preferido. Abre tu editor de código en la carpeta del proyecto.

El proyecto incluye un archivo README completo con instrucciones de configuración. Sigue estos pasos:

  1. Agrega tu clave de API de Anthropic al archivo .env
  2. Instala las dependencias usando UV (recomendado) o pip
  3. Ejecuta la aplicación inicial para verificar que todo funciona

Ejecutar la aplicación

Navega a tu directorio del proyecto en la terminal. Verás los archivos principales del proyecto, incluyendo main.py, mcp_client.py y mcp_server.py.

Para iniciar la aplicación, usa uno de estos comandos:

bash
# Si usas UV (recomendado)
uv run main.py

# Si usas Python estándar
python main.py

Cuando la aplicación se inicie correctamente, verás un indicador de chat.

Verifica tú mismo la línea base. Escribe una pregunta cuya respuesta puedas verificar a simple vista, como "¿cuánto es 1+1?". No te conformes con que aparezca una respuesta: confirma que la respuesta sea realmente 2. Una respuesta correcta demuestra que tu clave de API, las dependencias y el bucle de chat funcionan.

Luego escribe una segunda pregunta, algo como "¿qué dicen los documentos?". Sea lo que sea que obtengas, no puede provenir de las herramientas de documentos, porque aún no las has construido. La respuesta es el modelo respondiendo por su cuenta. Fíjate en qué componente será responsable de ese trabajo una vez que exista: el servidor gestiona las operaciones con documentos, y el cliente gestiona tu parte de la conversación.

El hábito detrás de esta verificación: ajusta el nivel de cuidado al verificar según el costo de estar equivocado. Una configuración rota aquí te cuesta cada lección posterior construida sobre ella; verificarla cuesta dos preguntas.

Una verificación que vale la pena mantener

El comportamiento a llevar más allá de este proyecto: cada vez que agregues una nueva capa a un proyecto de API, ya sea una herramienta, una fuente de datos o un servidor MCP, hazle al sistema en ejecución una pregunta cuya respuesta ya conozcas antes de construir la siguiente capa. Una línea base que has verificado es la única línea base contra la que puedes depurar.

Con la configuración básica completa, estamos listos para comenzar a implementar funciones de MCP y explorar cómo se comunican clientes y servidores a través del Model Context Protocol.

Descargas

  • Starter project (cli_project.zip)

    The chatbot project you build on for the rest of this section.

    Descargar
  • Completed project (cli_project_COMPLETE.zip)

    The finished version, for checking your work.

    Descargar