Vamos a construir nuestro propio chatbot basado en CLI para comprender mejor cómo funcionan juntos los clientes y servidores MCP. Este proyecto práctico te dará experiencia concreta con ambos lados de la arquitectura 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
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
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 existentes
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 servidores.