Cargando

Configuración del proyecto

Lección 517 min
Cargando

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

Qué vamos a construir

Nuestro chatbot permitirá a los usuarios interactuar con una colección de documentos mediante lenguaje natural. El sistema consta de dos componentes principales:

  • Un cliente MCP que gestiona las interacciones del usuario y se comunica con Claude
  • Un servidor MCP que proporciona herramientas para leer y actualizar documentos

Nuestro servidor contiene nuestro cliente MCP, que se comunica en ambas direcciones con nuestro servidor MCP, cuyas herramientas leen y actualizan cuatro documentos.

El servidor expondrá dos herramientas a Claude:

  • Herramienta para leer el contenido de un documento
  • Herramienta para actualizar el contenido de un documento

Todos los documentos se almacenan en memoria por simplicidad; incluyen archivos como document.pdf, spreadsheet.xlsx, report.txt y spec.md.

Nota importante sobre la arquitectura

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

  • Solo un servidor MCP para exponer las capacidades de tu servicio a modelos de IA
  • Solo un cliente MCP para conectarte a servidores MCP existentes construidos por otros desarrolladores

Diagrama de nuestro servidor que contiene el cliente MCP, el cual se conecta en ambas direcciones a 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.

Configuración

El proyecto incluye un archivo README.md con instrucciones detalladas de configuración. Necesitarás:

  1. Agregar tu clave de API de Anthropic al archivo .env
  2. Instalar las dependencias usando UV (recomendado) o pip

El README.md del proyecto, con el Paso 1 para establecer ANTHROPIC_API_KEY en el archivo .env y el Paso 2 para instalar las dependencias.

El archivo .env debe contener:

bash
ANTHROPIC_API_KEY="your-api-key-here"

Ejecución del proyecto

Una vez completada la configuración, navega al directorio de tu proyecto en la terminal y ejecuta:

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

# Si usas Python estándar
python main.py

Deberías ver aparecer un indicador de chat. Pruébalo haciendo una pregunta simple como "¿cuánto es 1+1?" para verificar que todo funciona correctamente.

El proyecto inicial ya incluye la funcionalidad básica de chat con Claude. En los siguientes videos, agregaremos capacidades de servidor MCP y funciones de gestión de documentos para crear un chatbot completamente funcional y consciente de los documentos.

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