AI Interaction Tool

# Windows with Chocolatey choco install python # macOS with Homebrew brew install python # Ubuntu/Debian sudo apt update && sudo apt install python3 python3-pip

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

⚙️ Step 4: Configure MCP Server in Claude Desktop

Add the following configuration to Claude Desktop config file:

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

- Open Command Palette (Cmd/Ctrl + Shift + P)
- Search "Configure MCP Servers"
- Add AI_interaction server config

- Copy content fromrule_for_ai_VI.txtorrule_for_ai_EN.txt
- Paste into "Custom Instructions" field in custom mode Agent:

- ✅Native MCP Support: Built-in integration with MCP servers
- ✅AI-First IDE: Optimized for AI development workflows
- ✅Real-time Suggestions: Context-aware code completion
- ✅Advanced Debugging: Enhanced debugging for MCP tools
- ✅Performance: Faster than traditional IDEs for AI projects

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

⚠️ Important: ReplaceE:/MCP-servers-github/AI-interaction/mcp_server.pywith the absolute path tomcp_server.pyon your system. ---> AUTO SHOW UI:
- Restart Claude Desktop/Cursorafter configuring MCP server
- Test connectionby callingai_interactiontool
- Test UI popupto verify functionality
- Validate rule integrationthrough AI agent responses

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

1.ai_interaction: Main Interactive Tool

- Function: Creates UI popup for user input with file/image attachment
- Output: Structured tag-based format with image support
- Integration: Perfect integration with system prompt rules
- Use cases:

- Input complex content with formatting
- Attach files/folders from workspace
- 🖼️ Attach images with drag & drop functionality
- 📷 Multi-image support with preview and management
- Control AI thinking modes and reasoning levels

# Programmatic usage from ai_interaction_tool import ai_interaction # Launch interactive interface result = ai_interaction() print(result) # Structured output with tags

- Drag & Drop Support: Drag images directly into the UI
- Multi-image Management: Attach, preview, and remove multiple images
- Format Support: PNG, JPG, JPEG, GIF, BMP, WEBP
- Secure Storage: Images stored safely inuser_images/directory
- Base64 Encoding: Automatic conversion for AI processing
- Preview System: Click images to view larger versions
- Persistent State: Save images option with checkbox persistence
- Attach Button: Click "📷 Attach Images" to select files
- Drag & Drop: Drag images from file explorer directly to UI
- Paste Support: Paste images from clipboard (Ctrl+V)
- Multiple Images: Attach as many images as needed
- Remove Images: Click X button on individual image previews
- Clear All: Use "🗑️ Clear Images" to remove all at once
- Save Toggle: Check/uncheck "Save images" to control persistence

- Local Only: All images stored locally inuser_images/
- No External Access: No uploads or external connections
- Relative Paths: Only relative paths stored in config for security
- User Control: Users control what images to attach and save
- Auto-cleanup: Images automatically cleaned when save disabled

AI Interaction Tool uses clean tag-based format:

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>

Note: When images are attached, they are automatically converted to base64 format and included in the response for AI processing.

- Check Python is installed and in PATH
- Verify absolute path in MCP config

- Runpip install -r requirements.txt
- Check virtual environment if using one

- Ensure PyQt5 is installed correctly
- Check display settings and desktop environment

- Verify file permissions and access rights
- Check workspace path configuration

- Ensure PyQt5 is properly installed for image processing
- Checkuser_images/directory permissions
- Verify image formats: PNG, JPG, JPEG, GIF, BMP, WEBP supported
- Clear config if images not loading: Removelast_attached_imagesfrom config.json

- Verify MCP server configuration in Cursor settings
- Check process running withps aux | grep mcp_server
- Restart Cursor after config changes

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

- 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

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

MIT License Copyright (c) 2025 DemonVN - AI Interaction Tool

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

- 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

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.

Integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account.

A cross-platform AI chat client supporting desktop, mobile, and web platforms.

Enables real-time communication between AI assistants and users via a web-based chat interface.

Connects an AI agent to a LINE Official Account using the LINE Messaging API.

A cross-platform desktop app for interacting with various Large Language Models (LLMs) through the Model Context Protocol (MCP).

Interact with RetellAI's voice services to create conversational voice AI.

Official MCP Server to interact with Pearl API. Connect your AI Agents with 12,000+ certified experts instantly.

Connect Tidio with your website via MCP. Embed the widget without exiting your programming environment.