MCP Chat

MCP Chat es una aplicación de interfaz de línea de comandos que permite capacidades de chat interactivo con modelos de IA a través de la API de Anthropic. La aplicación admite recuperación de documentos, indicaciones basadas en comandos e integraciones de herramientas extensibles mediante la arquitectura MCP (Model Control Protocol).

Requisitos previos

• Python 3.9+

• Clave de API de Anthropic

Configuración

Paso 1: Configurar las variables de entorno

1. Crea o edita el archivo .env en la raíz del proyecto y verifica que las siguientes variables estén configuradas correctamente:

ANTHROPIC_API_KEY=""  # Enter your Anthropic API secret key

Paso 2: Instalar dependencias

Opción 1: Configuración con uv (Recomendado)

uv es un instalador y resolvedor de paquetes de Python rápido.

1. Instala uv, si aún no está instalado:

pip install uv

2. Crea y activa un entorno virtual:

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Instala las dependencias:

uv pip install -e .

4. Ejecuta el proyecto

uv run main.py

Opción 2: Configuración sin uv

1. Crea y activa un entorno virtual:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

2. Instala las dependencias:

pip install anthropic python-dotenv prompt-toolkit "mcp[cli]==1.8.0"

3. Ejecuta el proyecto

python main.py

Uso

Interacción básica

Simplemente escribe tu mensaje y presiona Enter para chatear con el modelo.

Recuperación de documentos

Usa el símbolo @ seguido de un ID de documento para incluir el contenido del documento en tu consulta:

> Tell me about @deposition.md

Comandos

Usa el prefijo / para ejecutar comandos definidos en el servidor MCP:

> /summarize deposition.md

Los comandos se autocompletarán cuando presiones Tab.

Desarrollo

Añadir nuevos documentos

Edita el archivo mcp_server.py para añadir nuevos documentos al diccionario docs.

Implementar funciones de MCP

Para implementar completamente las funciones de MCP:

1. Completa los TODOs en mcp_server.py

2. Implementa la funcionalidad que falta en mcp_client.py

Comprobación de linting y tipado

No hay comprobaciones de lint ni de tipos implementadas.