Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1
Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/KhaiHuynhVN/MCP-Server_AI-interaction.git
cd MCP-Server_AI-interaction
pip install -r requirements.txt2
Register it in Claude Code
claude mcp add ai-interaction-tool -- python /absolute/path/to/mcp_server.pyReplace any placeholder paths in the command with the real path on your machine.
3
Make your agent remember this setup
ai-interaction-tool's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Interactive PyQt5 UI popup for content input and conversation control
- Multi-image attachment system with drag and drop support
- Workspace-aware file and folder attachment with validation
- Structured tag-based output format for AI agent integration
- Ten cognitive modes for enhanced AI performance
Try it
→Open the interactive UI to attach multiple images for analysis.
→Activate maximum cognitive power mode for this complex coding task.
→Continue the chat session using the AI_INTERACTION_CONTINUE_CHAT tag.
→Attach the project folder to the current context using the file attachment system.
Original README from KhaiHuynhVN/MCP-Server_AI-interaction
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:**
- Open Claude Desktop or access Claude web interface
- Find "Custom Instructions" or "Add custom instructions" in settings
- Copy entire content from one of the rule files:
- 🇻🇳 Vietnamese:
rule_for_ai_VI.txt - 🇺🇸 English:
rule_for_ai_EN.txt
- 🇻🇳 Vietnamese:
- 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:**
- Download Cursor: https://cursor.sh/
- Install and open workspace: Open AI-interaction folder
- Configure MCP in Cursor:
- Open Command Palette (
Cmd/Ctrl + Shift + P) - Search "Configure MCP Servers"
- Add AI_interaction server config
- Open Command Palette (
- Setup custom instructions:
- Copy content from
rule_for_ai_VI.txtorrule_for_ai_EN.txt - Paste into "Custom Instructions" field in custom mode Agent: ![image](https://github.com/us
- Copy content from