Labsco
KhaiHuynhVN logo

AI Interaction Tool

★ 29

from KhaiHuynhVN

An AI interaction tool with an advanced UI for the Model Context Protocol (MCP).

🔥🔥🔥✓ VerifiedFreeNeeds API keys
#automation#database#git#maps#security#monitoring#translation

AI Interaction Tool - MCP Server

Modern AI interaction tool with advanced UI and powerful features for Model Context Protocol (MCP)

🚀 Core Features

🎯 Main Capabilities

  • Interactive UI Popup for content input and conversation control
  • File/Folder Attachment from workspace with validation and preview
  • 🖼️ Image Attachment System with drag & drop, multi-image support
  • Multi-language Support (English/Vietnamese)
  • Maximum Cognitive Power activation for peak AI performance
  • Tag-based Output Format integrated with system prompt rules
  • Workspace-aware Path Processing for cross-project compatibility

🔧 New in v2.2.0 (Latest)

  • 🖼️ Image Attachment Support with drag & drop functionality
  • 🛡️ Security Enhanced - secure path storage in user_images directory
  • 💾 Persistent Image State - checkbox state saves correctly
  • 🎯 Multi-image Management - attach, preview, and remove multiple images
  • 🔄 Database Auto-cleanup - automatic image cleanup when disabled

🔧 Previous v2.1.0

  • Enhanced UI/UX with modern PyQt5 interface
  • Structured Tag-based Output for perfect AI agent integration
  • Debounce Configuration with smart auto-save mechanisms
  • Cursor IDE Integration with comprehensive setup guide

📦 Package Structure

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

🔄 Version History

  • v2.2.0 (Latest): 🖼️ Image Attachment System - Complete image support with drag & drop, multi-image management, security enhancements, and persistent state
  • v2.1.0: Enhanced UI/UX, Cursor IDE integration, Debounce config system
  • v2.0.0: Refactored architecture with modern PyQt5 UI
  • v1.x: Core functionality and basic features

🎯 v2.2.0 Detailed Changes:

  • ✅ Image Attachment UI: Full drag & drop interface with preview system
  • ✅ Multi-format Support: PNG, JPG, JPEG, GIF, BMP, WEBP compatibility
  • ✅ Security Hardening: Secure path storage, local-only processing
  • ✅ Database Management: Auto-cleanup, persistent storage, state management
  • ✅ UX Improvements: Click-to-enlarge, remove buttons, checkbox persistence
  • ✅ Performance: Optimized image loading with base64 conversion
  • ✅ Bug Fixes: Checkbox state persistence, config loading issues resolved

🎯 Integration Workflow & System Architecture

🔄 Complete Integration Flow:

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

🧠 Cognitive Enhancement System:

  • Standard Mode: High-level thinking with 1+ thinking blocks
  • Ultra-Enhancement Mode: 10 breakthrough cognitive modes simultaneously
    • Quantum Cognitive Mode
    • Meta-Cognitive Orchestration
    • Expert Persona Simulation
    • Time-Dilated Processing
    • Systems-Level Integration
    • Psychological Priming Mode
    • Maximum Cognitive Resource Allocation
    • Adversarial Self-Testing Mode
    • Obsessive Quality Standards
    • Breakthrough Innovation Mode

📊 Output Tag System:

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

💡 Advanced Features & Best Practices

🎨 UI/UX Enhancements:

  • Responsive Design: Adaptive sizing with minimum 800x700 resolution
  • Multi-language Support: Seamless EN/VI switching with persistent config
  • Modern PyQt5 Styling: Semantic color system with button properties
  • File Drag-Drop: Intuitive file attachment with validation
  • Context Menu: Right-click operations for file management
  • Debounce Saving: Smart config persistence with QTimer optimization

🔧 Technical Specifications:

  • Python: 3.8+ required with PyQt5 dependencies
  • Memory: Minimum 512MB RAM for UI components
  • Storage: ~50MB for tool installation and config
  • Platform: Cross-platform (Windows/macOS/Linux) with native styling
  • Performance: Event-driven architecture with minimal CPU usage

📈 Performance Optimization:

  • Lazy Loading: Components load only when needed
  • Efficient Config: JSON-based with automatic compression
  • Resource Management: Proper cleanup and memory management
  • Caching Strategy: Workspace state persistence for faster startup

🛡️ Security & Privacy

🔒 Security Features:

  • Local Processing: All file operations are local only, no uploads
  • Path Validation: Robust security checks for file access
  • Sandboxed Execution: Tool runs in controlled environment
  • No Data Collection: Zero telemetry or external data transmission

🔐 Privacy Protection:

  • Config Encryption: Local config with secure storage options
  • File Access Control: User-controlled file attachment permissions
  • Workspace Isolation: Project boundaries are enforced
  • Audit Trail: Optional logging for security monitoring

🤝 Contributing

Note: This is a private repository. Only the owner has push access.

For suggestions or issues:

  1. Create detailed issue reports
  2. Provide reproduction steps
  3. Include system information
  4. Attach relevant logs or screenshots

📚 Documentation & Resources

📖 Documentation Files:

  • rule_for_ai_VI.txt - Vietnamese agent behavior rules
  • rule_for_ai_EN.txt - English agent behavior rules
  • SYSTEM_PROMPT_Claude-4-sonnet-max.txt - Full system prompt example
  • pyproject.toml - Project configuration and dependencies

🔗 Useful Links:

💡 Related Projects:

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

📄 License & Legal

📜 License:

MIT License

Copyright (c) 2025 DemonVN - AI Interaction Tool

⚖️ Legal Notes:

  • Tool complies with local processing requirements
  • No personal data collection
  • Respects user privacy and data sovereignty
  • Compatible with enterprise security policies

🎯 Special Thanks:

  • Model Context Protocol team for standardized interface
  • Claude Desktop integration ecosystem
  • Cursor IDE team for AI-first development tools
  • Open source Python community
  • Beta testers and early adopters

🔥 Inspiration:

Project inspired by the need for seamless AI interaction tools with modern UX principles and professional-grade architecture.

🚀 Happy Coding with AI Interaction Tool!

For support, issues, or feature requests, please open an issue on the GitHub repository.