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 la recuperación de documentos, mensajes basados en comandos e integraciones de herramientas extensibles a través de 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. Cree o edite el archivo .env en la raíz del proyecto y verifique 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. Instale uv, si aún no está instalado:

pip install uv

2. Cree y active un entorno virtual:

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

3. Instale las dependencias:

uv pip install -e .

4. Ejecute el proyecto

uv run main.py

Opción 2: Configuración sin uv

1. Cree y active un entorno virtual:

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

2. Instale las dependencias:

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

3. Ejecute el proyecto

python main.py

Uso

Interacción básica

Simplemente escriba su mensaje y presione Enter para chatear con el modelo.

Recuperación de documentos

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

> Tell me about @deposition.md

Comandos

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

> /summarize deposition.md

Los comandos se autocompletarán cuando presione Tab.

Desarrollo

Agregar nuevos documentos

Edite el archivo mcp_server.py para agregar nuevos documentos al diccionario docs.

Implementación de funciones MCP

Para implementar completamente las funciones MCP:

1. Complete los TODOs en mcp_server.py

2. Implemente la funcionalidad faltante en mcp_client.py

Linting y verificación de tipos

No hay comprobaciones de lint o de tipo implementadas.