AI Interaction Tool MCP Server

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

📋 Installation & Setup Guide

📥 Step 1: Clone Repository

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
• Or use package manager:

  # 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

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

{
  "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
4. 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 <AI_INTERACTION_CONTINUE_CHAT>
• ✅ 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:**

# 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

🚀 Step 6: Configure Cursor IDE (Recommended)

Cursor is the recommended IDE for AI development with this tool:

📋 **Cursor Setup Steps:**

1. Download Cursor: https://cursor.sh/
2. Install and open workspace: Open AI-interaction folder
3. Configure MCP in Cursor:
   • Open Command Palette (Cmd/Ctrl + Shift + P)
   • Search "Configure MCP Servers"
   • Add AI_interaction server config
4. Setup custom instructions:
   • Copy content from rule_for_ai_VI.txt or rule_for_ai_EN.txt
   • Paste into "Custom Instructions" field in custom mode Agent: ![image](https://github.com/us