Cargando

Configuración del proyecto

Lección 501 min
Cargando

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

Qué vamos a construir

Nuestro chatbot será una interfaz de línea de comandos que permite a los usuarios chatear con un conjunto de documentos. Esto es lo que incluirá el sistema:

  • Una interfaz de chatbot basada en CLI
  • Capacidades de lectura y edición de documentos para Claude
  • Funcionalidad de "mención" de documentos usando la sintaxis @doc_name
  • Ejecución de comandos con la sintaxis /command_name
  • Una colección de documentos ficticios almacenados en memoria

Al escribir @ en un prompt se listan deposition.md, design.md, financials.md, outlook.md, plan.md y spec.md, todos etiquetados como "Resource".

Arquitectura del sistema

El proyecto consta de tres componentes principales que trabajan juntos:

  • Nuestro cliente MCP - Gestiona la interacción del usuario y la interfaz de chat
  • Nuestro servidor MCP - Proporciona herramientas para operaciones con documentos
  • Almacenamiento de documentos - Colección en memoria de varios tipos de archivos

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

El servidor MCP implementará dos herramientas principales:

  • Herramienta para leer el contenido de documentos
  • Herramienta para actualizar el contenido de documentos

Todos los documentos (PDFs, hojas de cálculo, archivos de texto, archivos markdown) se almacenarán en memoria en lugar de en disco, manteniendo el proyecto simple y enfocado en los conceptos de MCP.

Nota importante sobre la arquitectura

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

  • Construir un servidor MCP para distribuir un servicio a otros desarrolladores
  • Construir un cliente MCP que se conecte a servidores MCP de terceros ya existentes

Diagrama de nuestro servidor que contiene el cliente MCP, el cual se conecta en ambas direcciones a un servidor MCP independiente.

Nuestro proyecto implementa ambos componentes en una sola base de código puramente con fines educativos, para que puedas ver cómo interactúan entre sí los clientes y los servidores.