AI Interaction Tool

Una herramienta de interacción con IA con una interfaz de usuario avanzada para el Protocolo de Contexto de Modelo (MCP).

GitHub

Prueba este MCPPatrocinado

Documentación

AI Interaction Tool - Servidor MCP

Herramienta moderna de interacción con IA con interfaz de usuario avanzada y potentes funciones para el Protocolo de Contexto de Modelos (MCP)

🚀 Funciones Principales

🎯 Capacidades Principales

Ventana Emergente de Interfaz de Usuario Interactiva para entrada de contenido y control de conversación
Adjuntar Archivos/Carpetas desde el espacio de trabajo con validación y vista previa
🖼️ Sistema de Adjuntar Imágenes con arrastrar y soltar, soporte multi-imagen
Soporte Multi-idioma (Inglés/Vietnamita)
Activación de Potencia Cognitiva Máxima para rendimiento óptimo de IA
Formato de Salida Basado en Etiquetas integrado con reglas del prompt del sistema
Procesamiento de Rutas Consciente del Espacio de Trabajo para compatibilidad entre proyectos

🔧 Nuevo en v2.2.0 (Última Versión)

🖼️ Soporte para Adjuntar Imágenes con funcionalidad de arrastrar y soltar
🛡️ Seguridad Mejorada - almacenamiento seguro de rutas en el directorio user_images
💾 Estado de Imágenes Persistente - el estado de la casilla de verificación se guarda correctamente
🎯 Gestión Multi-imagen - adjuntar, previsualizar y eliminar múltiples imágenes
🔄 Limpieza Automática de Base de Datos - limpieza automática de imágenes al desactivarse

🔧 Versión Anterior v2.1.0

Interfaz de Usuario/UX Mejorada con interfaz moderna PyQt5
Salida Estructurada Basada en Etiquetas para integración perfecta con agentes de IA
Configuración de Debounce con mecanismos inteligentes de guardado automático
Integración con Cursor IDE con guía de configuración completa

📋 Guía de Instalación y Configuración

📥 Paso 1: Clonar Repositorio

git clone https://github.com/your-username/AI-interaction.git
cd AI-interaction

🐍 Paso 2: Instalar Python

Requisito: Python 3.8+
Descargar desde python.org

O usar el gestor de paquetes:

# Windows with Chocolatey
choco install python

# macOS with Homebrew
brew install python

# Ubuntu/Debian
sudo apt update && sudo apt install python3 python3-pip

📦 Paso 3: Instalar Dependencias

# Using pip
pip install -r requirements.txt

# Or using uv (recommended for performance)
pip install uv
uv pip install -r requirements.txt

⚙️ Paso 4: Configurar Servidor MCP en Claude Desktop

Agregue la siguiente configuración al archivo de configuración de Claude Desktop:

Rutas del archivo de configuración:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json

Contenido de la configuración:

{
  "mcpServers": {
    "AI_interaction": {
      "command": "python",
      "args": ["E:/MCP-servers-github/AI-interaction/mcp_server.py"],
      "stdio": true,
      "enabled": true
    }
  }
}

⚠️ Importante: Reemplace E:/MCP-servers-github/AI-interaction/mcp_server.py con la ruta absoluta a mcp_server.py en su sistema.

🧠 Paso 5: Configurar Reglas del Agente de IA (REQUERIDO)

Para el funcionamiento adecuado del agente de IA con la herramienta ai_interaction, DEBE configurar instrucciones personalizadas:

📋 Cómo Agregar Instrucciones Personalizadas:

Abra Claude Desktop o acceda a la interfaz web de Claude
Busque "Instrucciones Personalizadas" o "Agregar instrucciones personalizadas" en la configuración
Copie todo el contenido de uno de los archivos de reglas:
- 🇻🇳 Vietnamita: rule_for_ai_VI.txt
- 🇺🇸 Inglés: rule_for_ai_EN.txt
Pegue en el campo de instrucciones personalizadas y guarde

🎯 Por Qué Esto es Necesario:

✅ Marco de Comportamiento: Las reglas definen cómo el agente de IA procesa la salida de ai_interaction
✅ Protocolos de Pensamiento: Activa patrones de pensamiento de alto nivel para respuestas de calidad
✅ Modos de Ultra-Mejora: 10 modos cognitivos para máximo rendimiento
✅ Procesamiento de Etiquetas: Lee y procesa etiquetas de control como <AI_INTERACTION_CONTINUE_CHAT>
✅ Lógica de Continuación: Auto-recuperación de ai_interaction cuando continue_chat=true

📁 Ubicación de los Archivos de Reglas:

AI-interaction/
├── rule_for_ai_VI.txt    # Vietnamese rules 
├── rule_for_ai_EN.txt    # English rules
└── ...

⚡ Comandos de Configuración Rápida:

# View Vietnamese rules content
cat rule_for_ai_VI.txt

# View English rules content  
cat rule_for_ai_EN.txt

# Copy to clipboard (Windows)
type rule_for_ai_VI.txt | clip

# Copy to clipboard (macOS)
cat rule_for_ai_VI.txt | pbcopy

# Copy to clipboard (Linux)
cat rule_for_ai_VI.txt | xclip -selection clipboard

🚀 Paso 6: Configurar Cursor IDE (Recomendado)

Cursor es el IDE recomendado para desarrollo de IA con esta herramienta:

📋 Pasos de Configuración de Cursor:

Descargar Cursor: https://cursor.sh/
Instalar y abrir el espacio de trabajo: Abra la carpeta AI-interaction
Configurar MCP en Cursor:
- Abra la Paleta de Comandos (Cmd/Ctrl + Shift + P)
- Busque "Configurar Servidores MCP"
- Agregue la configuración del servidor AI_interaction
Configurar instrucciones personalizadas:
- Copie el contenido de rule_for_ai_VI.txt o rule_for_ai_EN.txt
- Pegue en el campo "Instrucciones Personalizadas" en el modo personalizado Agente:

🎯 Ventajas de Cursor:

✅ Soporte MCP Nativo: Integración incorporada con servidores MCP
✅ IDE Primero-IA: Optimizado para flujos de trabajo de desarrollo de IA
✅ Sugerencias en Tiempo Real: Completado de código consciente del contexto
✅ Depuración Avanzada: Depuración mejorada para herramientas MCP
✅ Rendimiento: Más rápido que los IDEs tradicionales para proyectos de IA

🚀 Paso 7: Iniciar y Probar

!!! -----> En su terminal: python E:\MCP-servers-github\AI-interaction\main.py --ui

⚠️ Importante: Reemplace E:/MCP-servers-github/AI-interaction/mcp_server.py con la ruta absoluta a mcp_server.py en su sistema. ---> MOSTRAR UI AUTOMÁTICAMENTE:

Reinicie Claude Desktop/Cursor después de configurar el servidor MCP
Pruebe la conexión llamando a la herramienta ai_interaction
Pruebe la ventana emergente de UI para verificar la funcionalidad
Valide la integración de reglas a través de las respuestas del agente de IA

📦 Estructura del Paquete

AI-interaction/
├── ai_interaction_tool/       # Main interaction tool package
│   ├── core/                 # Core dialog and configuration
│   │   ├── dialog.py         # InputDialog with PyQt5 UI
│   │   └── config.py         # Configuration management
│   ├── ui/                   # Interface and styling
│   │   ├── file_dialog.py    # File attachment dialogs
│   │   ├── file_tree.py      # File system tree view
│   │   ├── image_attachment.py # 🖼️ Image attachment with drag & drop
│   │   └── styles.py         # Modern UI styling
│   ├── utils/                # Utilities and multi-language
│   │   ├── translations.py   # Multi-language support
│   │   └── file_utils.py     # File operation utilities
│   ├── engine.py             # Main entry point
│   ├── description.py        # Detailed tool description
│   └── __init__.py           # Package exports
├── user_images/              # 🛡️ Secure image storage directory
├── main.py                   # Legacy entry point
├── mcp_server.py             # MCP server implementation
├── requirements.txt          # Python dependencies
├── pyproject.toml           # Project configuration
└── README.md                # This file

🎮 Guía de Uso

Herramientas Disponibles en el Servidor MCP

1. ai_interaction: Herramienta Interactiva Principal

Función: Crea ventana emergente de UI para entrada del usuario con adjuntar archivos/imágenes
Salida: Formato estructurado basado en etiquetas con soporte de imágenes
Integración: Integración perfecta con reglas del prompt del sistema
Casos de uso:
- Ingresar contenido complejo con formato
- Adjuntar archivos/carpetas desde el espacio de trabajo
- 🖼️ Adjuntar imágenes con funcionalidad de arrastrar y soltar
- 📷 Soporte multi-imagen con vista previa y gestión
- Controlar modos de pensamiento de IA y niveles de razonamiento

Ejemplos Básicos de Uso

# Programmatic usage
from ai_interaction_tool import ai_interaction

# Launch interactive interface
result = ai_interaction()
print(result)  # Structured output with tags

🖼️ Funciones de Adjuntar Imágenes

📷 Capacidades Principales de Imágenes

Soporte de Arrastrar y Soltar: Arrastre imágenes directamente a la UI
Gestión Multi-imagen: Adjuntar, previsualizar y eliminar múltiples imágenes
Formatos Soportados: PNG, JPG, JPEG, GIF, BMP, WEBP
Almacenamiento Seguro: Imágenes almacenadas de forma segura en el directorio user_images/
Codificación Base64: Conversión automática para procesamiento de IA
Sistema de Vista Previa: Haga clic en las imágenes para ver versiones más grandes
Estado Persistente: Opción de guardar imágenes con persistencia de casilla de verificación

🎯 Cómo Usar el Adjuntar Imágenes

Botón Adjuntar: Haga clic en "📷 Adjuntar Imágenes" para seleccionar archivos
Arrastrar y Soltar: Arrastre imágenes desde el explorador de archivos directamente a la UI
Soporte de Pegar: Pegue imágenes desde el portapapeles (Ctrl+V)
Múltiples Imágenes: Adjunte tantas imágenes como necesite
Eliminar Imágenes: Haga clic en el botón X en las vistas previas individuales
Borrar Todo: Use "🗑️ Borrar Imágenes" para eliminar todas a la vez
Alternar Guardado: Marque/desmarque "Guardar imágenes" para controlar la persistencia

🛡️ Seguridad y Privacidad

Solo Local: Todas las imágenes se almacenan localmente en user_images/
Sin Acceso Externo: Sin cargas ni conexiones externas
Rutas Relativas: Solo se almacenan rutas relativas en la configuración por seguridad
Control del Usuario: Los usuarios controlan qué imágenes adjuntar y guardar
Limpieza Automática: Las imágenes se limpian automáticamente cuando el guardado está desactivado

Formato de Salida

AI Interaction Tool usa un formato limpio basado en etiquetas:

User message content with natural line breaks

<AI_INTERACTION_ATTACHED_FILES>
FOLDERS:
- workspace_name/relative/path/to/folder

FILES:
- workspace_name/relative/path/to/file.js
</AI_INTERACTION_ATTACHED_FILES>

<AI_INTERACTION_WORKSPACE>workspace_name</AI_INTERACTION_WORKSPACE>
<AI_INTERACTION_CONTINUE_CHAT>true/false</AI_INTERACTION_CONTINUE_CHAT>

Nota: Cuando se adjuntan imágenes, se convierten automáticamente a formato base64 y se incluyen en la respuesta para el procesamiento de IA.

🔧 Solución de Problemas

Problemas Comunes

Error "Comando no encontrado"
- Verifique que Python esté instalado y en PATH
- Verifique la ruta absoluta en la configuración MCP
Error "Módulo no encontrado"
- Ejecute pip install -r requirements.txt
- Verifique el entorno virtual si está usando uno
La UI no se muestra
- Asegúrese de que PyQt5 esté instalado correctamente
- Verifique la configuración de pantalla y el entorno de escritorio
El adjuntar archivos no funciona
- Verifique los permisos de archivos y derechos de acceso
- Verifique la configuración de ruta del espacio de trabajo
🖼️ Problemas con el adjuntar imágenes
- Asegúrese de que PyQt5 esté instalado correctamente para el procesamiento de imágenes
- Verifique los permisos del directorio user_images/
- Verifique los formatos de imagen: PNG, JPG, JPEG, GIF, BMP, WEBP soportados
- Borre la configuración si las imágenes no cargan: Elimine last_attached_images de config.json
Problemas de Conexión MCP en Cursor
- Verifique la configuración del servidor MCP en la configuración de Cursor
- Verifique que el proceso esté ejecutándose con ps aux | grep mcp_server
- Reinicie Cursor después de cambios de configuración

Modo de Depuración

Para depurar problemas, ejecute el servidor directamente:

python mcp_server.py

Para depuración en Cursor:

# Check MCP server logs in Cursor
# Open Developer Tools → Console
# Look for MCP connection messages

🔄 Historial de Versiones

v2.2.0 (Última): 🖼️ Sistema de Adjuntar Imágenes - Soporte completo de imágenes con arrastrar y soltar, gestión multi-imagen, mejoras de seguridad y estado persistente
v2.1.0: UI/UX mejorada, integración con Cursor IDE, sistema de configuración Debounce
v2.0.0: Arquitectura refactorizada con UI moderna PyQt5
v1.x: Funcionalidad principal y características básicas

🎯 Cambios Detallados de v2.2.0:

✅ UI de Adjuntar Imágenes: Interfaz completa de arrastrar y soltar con sistema de vista previa
✅ Soporte Multi-formato: Compatibilidad con PNG, JPG, JPEG, GIF, BMP, WEBP
✅ Refuerzo de Seguridad: Almacenamiento seguro de rutas, procesamiento solo local
✅ Gestión de Base de Datos: Limpieza automática, almacenamiento persistente, gestión de estado
✅ Mejoras de UX: Hacer clic para ampliar, botones de eliminar, persistencia de casilla de verificación
✅ Rendimiento: Carga de imágenes optimizada con conversión base64
✅ Correcciones de Errores: Persistencia del estado de casilla de verificación, problemas de carga de configuración resueltos

🎯 Flujo de Trabajo de Integración y Arquitectura del Sistema

🔄 Flujo de Integración Completo:

[User Input] → [ai_interaction Tool] → [Tag-based Output] → [AI Agent Rules] → [Enhanced Response]
     ↑                                                                              ↓
     └─────────────── [Auto-recall if continue_chat=true] ←─────────────────────────┘

🧠 Sistema de Mejora Cognitiva:

Modo Estándar: Pensamiento de alto nivel con 1+ bloques de pensamiento
Modo de Ultra-Mejora: 10 modos cognitivos innovadores simultáneamente
- Modo Cognitivo Cuántico
- Orquestación Meta-Cognitiva
- Simulación de Persona Experta
- Procesamiento de Tiempo Dilatado
- Integración a Nivel de Sistemas
- Modo de Preparación Psicológica
- Asignación Máxima de Recursos Cognitivos
- Modo de Autoevaluación Adversarial
- Estándares de Calidad Obsesivos
- Modo de Innovación Innovadora

📊 Sistema de Etiquetas de Salida:

<AI_INTERACTION_CONTINUE_CHAT>true/false</AI_INTERACTION_CONTINUE_CHAT>
<AI_INTERACTION_ATTACHED_FILES>
FOLDERS:
- workspace_name/relative/path/folder
FILES:  
- workspace_name/relative/path/file.ext
</AI_INTERACTION_ATTACHED_FILES>
<AI_INTERACTION_WORKSPACE>workspace_name</AI_INTERACTION_WORKSPACE>

💡 Funciones Avanzadas y Mejores Prácticas

🎨 Mejoras de UI/UX:

Diseño Responsivo: Tamaño adaptable con resolución mínima de 800x700
Soporte Multi-idioma: Cambio fluido EN/VI con configuración persistente
Estilo Moderno PyQt5: Sistema de colores semánticos con propiedades de botones
Arrastrar y Soltar Archivos: Adjuntar archivos intuitivo con validación
Menú Contextual: Operaciones con clic derecho para gestión de archivos
Guardado con Debounce: Persistencia inteligente de configuración con optimización QTimer

🔧 Especificaciones Técnicas:

Python: 3.8+ requerido con dependencias PyQt5
Memoria: Mínimo 512MB RAM para componentes de UI
Almacenamiento: ~50MB para instalación de la herramienta y configuración
Plataforma: Multiplataforma (Windows/macOS/Linux) con estilo nativo
Rendimiento: Arquitectura basada en eventos con uso mínimo de CPU

📈 Optimización de Rendimiento:

Carga Perezosa: Los componentes se cargan solo cuando es necesario
Configuración Eficiente: Basada en JSON con compresión automática
Gestión de Recursos: Limpieza adecuada y gestión de memoria
Estrategia de Caché: Persistencia del estado del espacio de trabajo para inicio más rápido

🛡️ Seguridad y Privacidad

🔒 Funciones de Seguridad:

Procesamiento Local: Todas las operaciones de archivos son solo locales, sin cargas
Validación de Rutas: Verificaciones de seguridad robustas para acceso a archivos
Ejecución en Entorno Aislado: La herramienta se ejecuta en entorno controlado
Sin Recopilación de Datos: Cero telemetría o transmisión de datos externa

🔐 Protección de Privacidad:

Cifrado de Configuración: Configuración local con opciones de almacenamiento seguro
Control de Acceso a Archivos: Permisos de adjuntar archivos controlados por el usuario
Aislamiento del Espacio de Trabajo: Se aplican límites de proyecto
Registro de Auditoría: Registro opcional para monitoreo de seguridad

🌟 Requisitos del Sistema y Compatibilidad

💻 Requisitos Mínimos del Sistema:

OS: Windows 10+ / macOS 10.14+ / Ubuntu 18.04+
Python: 3.8 or higher
RAM: 512MB available
Storage: 100MB free space
Display: 1024x768 minimum resolution

🎯 Configuración Recomendada:

OS: Windows 11 / macOS 12+ / Ubuntu 20.04+
Python: 3.10+ with virtual environment
RAM: 2GB available  
Storage: 500MB free space
Display: 1920x1080 or higher
GPU: Optional for enhanced UI rendering

🔧 Matriz de Compatibilidad:

Componente	Versión	Estado	Notas
Python	3.8-3.11	✅ Probado	Recomendado 3.10+
PyQt5	5.15+	✅ Requerido	Marco de UI principal
Claude Desktop	Última	✅ Optimizado	Integración MCP
Cursor IDE	Última	🚀 Recomendado	Desarrollo centrado en IA
VS Code	Cualquiera	✅ Compatible	Opción alternativa de IDE

🤝 Contribución

Nota: Este es un repositorio privado. Solo el propietario tiene acceso de push.

Para sugerencias o problemas:

Crea informes de problemas detallados
Proporciona pasos de reproducción
Incluye información del sistema
Adjunta registros o capturas de pantalla relevantes

📚 Documentación y Recursos

📖 Archivos de Documentación:

rule_for_ai_VI.txt - Reglas de comportamiento del agente vietnamita
rule_for_ai_EN.txt - Reglas de comportamiento del agente en inglés
SYSTEM_PROMPT_Claude-4-sonnet-max.txt - Ejemplo completo de prompt del sistema
pyproject.toml - Configuración del proyecto y dependencias

🔗 Enlaces Útiles:

💡 Proyectos Relacionados:

- https://github.com/KhaiHuynhVN/mcp-server-agent-comm

📄 Licencia y Cuestiones Legales

📜 Licencia:

MIT License

Copyright (c) 2025 DemonVN - AI Interaction Tool

⚖️ Notas Legales:

La herramienta cumple con los requisitos de procesamiento local
No recopila datos personales
Respeta la privacidad del usuario y la soberanía de los datos
Compatible con políticas de seguridad empresarial

🎯 Agradecimientos Especiales:

Equipo de Model Context Protocol por la interfaz estandarizada
Ecosistema de integración de Claude Desktop
Equipo de Cursor IDE por las herramientas de desarrollo centradas en IA
Comunidad de código abierto de Python
Probadores beta y primeros usuarios

🔥 Inspiración:

Proyecto inspirado en la necesidad de herramientas de interacción con IA sin fricciones con principios de UX modernos y arquitectura de nivel profesional.

🚀 ¡Feliz programación con AI Interaction Tool!

Para soporte, problemas o solicitudes de funciones, abre un issue en el repositorio de GitHub.