MCP Chat

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

Requisitos previos

• Python 3.9+

• Clave de API de Anthropic

Related MCP server: MCP Chat

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 las dependencias

Opción 1: Configurar con uv (recomendada)

uv es un instalador y resolutor 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: Configurar 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 pulsa Enter para hablar 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 pulses Tab.

Desarrollo

Añadir nuevos documentos

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

Implementación de funcionalidades MCP

Para implementar por completo las funcionalidades de MCP:

1. Completa los TODOs en mcp_server.py

2. Implementa la funcionalidad que falta en mcp_client.py

Comprobación de lint y de tipos

No hay comprobaciones de lint ni de tipos implementadas.