ai-interaction

🎯 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

📥 Step 1: Clone Repository

```bash

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

cd AI-interaction

```

🐍 Step 2: Install Python

• Requirement: Python 3.8+
• Download from [python.org](https://www.python.org/downloads/)
• Or use package manager:

```bash

# Windows with Chocolatey

choco install python

# macOS with Homebrew

brew install python

# Ubuntu/Debian

sudo apt update && sudo apt install python3 python3-pip

```

📦 Step 3: Install Dependencies

```bash

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

Config file paths:

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

Configuration content:

```json

{

"mcpServers": {

"AI_interaction": {

"command": "python",

"args": ["E:/MCP-servers-github/AI-interaction/mcp_server.py"],

"stdio": true,

"enabled": true

}

}

}

```

⚠️ Important: Replace E:/MCP-servers-github/AI-interaction/mcp_server.py with the absolute path to mcp_server.py on your system.

🧠 Step 5: Configure AI Agent Rules (REQUIRED)

For proper AI agent operation with ai_interaction tool, you MUST setup custom instructions:

#### 📋 How to Add Custom Instructions:

1. Open Claude Desktop or access Claude web interface
2. Find "Custom Instructions" or "Add custom instructions" in settings
3. Copy entire content from one of the rule files:

- 🇻🇳 Vietnamese: rule_for_ai_VI.txt

- 🇺🇸 English: rule_for_ai_EN.txt

1. Paste into custom instructions field and save

#### 🎯 Why This is Necessary:

• ✅ Behavioral Framework: Rules define how AI agent processes ai_interaction output
• ✅ Thinking Protocols: Activates high-level thinking patterns for quality responses
• ✅ Ultra-Enhancement Modes: 10 cognitive modes for maximum performance
• ✅ Tag Processing: Reads and processes control tags like
• ✅ Continue Logic: Auto-recall ai_interaction when continue_chat=true

#### 📁 Rule Files Location:

```

AI-interaction/

├── rule_for_ai_VI.txt # Vietnamese rules

├── rule_for_ai_EN.txt # English rules

└── ...

```

#### ⚡ Quick Setup Commands: