AI Interaction Tool

Uma ferramenta de interação de IA com uma interface de usuário avançada para o Model Context Protocol (MCP).

GitHub

Experimente este MCPPatrocinado

Documentação

AI Interaction Tool - Servidor MCP

Ferramenta moderna de interação com IA, com UI avançada e recursos poderosos para Model Context Protocol (MCP)

🚀 Recursos Principais

🎯 Principais Capacidades

Popup de UI Interativo para entrada de conteúdo e controle de conversa
Anexo de Arquivos/Pastas do workspace com validação e pré-visualização
🖼️ Sistema de Anexo de Imagens com arrastar e soltar, suporte a múltiplas imagens
Suporte a Múltiplos Idiomas (Inglês/Vietnamita)
Ativação de Poder Cognitivo Máximo para desempenho máximo da IA
Formato de Saída Baseado em Tags integrado às regras do prompt do sistema
Processamento de Caminhos Ciente do Workspace para compatibilidade entre projetos

🔧 Novidades na v2.2.0 (Mais Recente)

🖼️ Suporte a Anexo de Imagens com funcionalidade de arrastar e soltar
🛡️ Segurança Aprimorada - armazenamento seguro de caminhos no diretório user_images
💾 Estado Persistente de Imagens - o estado da caixa de seleção é salvo corretamente
🎯 Gerenciamento de Múltiplas Imagens - anexar, pré-visualizar e remover múltiplas imagens
🔄 Limpeza Automática do Banco de Dados - limpeza automática de imagens quando desativado

🔧 Versão Anterior v2.1.0

UI/UX Aprimorado com interface moderna PyQt5
Saída Estruturada Baseada em Tags para integração perfeita com agentes de IA
Configuração de Debounce com mecanismos inteligentes de salvamento automático
Integração com Cursor IDE com guia completo de configuração

📋 Guia de Instalação e Configuração

📥 Passo 1: Clonar Repositório

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

🐍 Passo 2: Instalar Python

Requisito: Python 3.8+
Baixe em python.org

Ou use o gerenciador de pacotes:

# Windows with Chocolatey
choco install python

# macOS with Homebrew
brew install python

# Ubuntu/Debian
sudo apt update && sudo apt install python3 python3-pip

📦 Passo 3: Instalar Dependências

# Using pip
pip install -r requirements.txt

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

⚙️ Passo 4: Configurar o Servidor MCP no Claude Desktop

Adicione a seguinte configuração ao arquivo de configuração do Claude Desktop:

Caminhos do arquivo de configuração:

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

Conteúdo da configuração:

{
  "mcpServers": {
    "AI_interaction": {
      "command": "python",
      "args": ["E:/MCP-servers-github/AI-interaction/mcp_server.py"],
      "stdio": true,
      "enabled": true
    }
  }
}

⚠️ Importante: Substitua E:/MCP-servers-github/AI-interaction/mcp_server.py pelo caminho absoluto para mcp_server.py no seu sistema.

🧠 Passo 5: Configurar Regras do Agente de IA (OBRIGATÓRIO)

Para a operação adequada do agente de IA com a ferramenta ai_interaction, você DEVE configurar instruções personalizadas:

📋 Como Adicionar Instruções Personalizadas:

Abra o Claude Desktop ou acesse a interface web do Claude
Encontre "Instruções Personalizadas" ou "Adicionar instruções personalizadas" nas configurações
Copie todo o conteúdo de um dos arquivos de regras:
- 🇻🇳 Vietnamita: rule_for_ai_VI.txt
- 🇺🇸 Inglês: rule_for_ai_EN.txt
Cole no campo de instruções personalizadas e salve

🎯 Por Que Isso é Necessário:

✅ Estrutura Comportamental: As regras definem como o agente de IA processa a saída do ai_interaction
✅ Protocolos de Pensamento: Ativa padrões de pensamento de alto nível para respostas de qualidade
✅ Modos de Ultra-Realce: 10 modos cognitivos para desempenho máximo
✅ Processamento de Tags: Lê e processa tags de controle como <AI_INTERACTION_CONTINUE_CHAT>
✅ Lógica de Continuação: Rechamada automática do ai_interaction quando continue_chat=true

📁 Localização dos Arquivos de Regras:

AI-interaction/
├── rule_for_ai_VI.txt    # Vietnamese rules 
├── rule_for_ai_EN.txt    # English rules
└── ...

⚡ Comandos Rápidos de Configuração:

# 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

🚀 Passo 6: Configurar o Cursor IDE (Recomendado)

O Cursor é o IDE recomendado para desenvolvimento de IA com esta ferramenta:

📋 Passos de Configuração do Cursor:

Baixe o Cursor: https://cursor.sh/
Instale e abra o workspace: Abra a pasta AI-interaction
Configure o MCP no Cursor:
- Abra a Paleta de Comandos (Cmd/Ctrl + Shift + P)
- Pesquise "Configurar Servidores MCP"
- Adicione a configuração do servidor AI_interaction
Configure instruções personalizadas:
- Copie o conteúdo de rule_for_ai_VI.txt ou rule_for_ai_EN.txt
- Cole no campo "Instruções Personalizadas" no modo personalizado do Agente:

🎯 Vantagens do Cursor:

✅ Suporte Nativo a MCP: Integração integrada com servidores MCP
✅ IDE Focado em IA: Otimizado para fluxos de trabalho de desenvolvimento de IA
✅ Sugestões em Tempo Real: Conclusão de código consciente do contexto
✅ Depuração Avançada: Depuração aprimorada para ferramentas MCP
✅ Desempenho: Mais rápido que IDEs tradicionais para projetos de IA

🚀 Passo 7: Iniciar e Testar

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

⚠️ Importante: Substitua E:/MCP-servers-github/AI-interaction/mcp_server.py pelo caminho absoluto para mcp_server.py no seu sistema. ---> MOSTRAR UI AUTOMATICAMENTE:

Reinicie o Claude Desktop/Cursor após configurar o servidor MCP
Teste a conexão chamando a ferramenta ai_interaction
Teste o popup da UI para verificar a funcionalidade
Valide a integração das regras através das respostas do agente de IA

📦 Estrutura do Pacote

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

🎮 Guia de Uso

Ferramentas Disponíveis no Servidor MCP

1. ai_interaction: Ferramenta Interativa Principal

Função: Cria popup de UI para entrada do usuário com anexo de arquivos/imagens
Saída: Formato estruturado baseado em tags com suporte a imagens
Integração: Integração perfeita com regras do prompt do sistema
Casos de uso:
- Inserir conteúdo complexo com formatação
- Anexar arquivos/pastas do workspace
- 🖼️ Anexar imagens com funcionalidade de arrastar e soltar
- 📷 Suporte a múltiplas imagens com pré-visualização e gerenciamento
- Controlar modos de pensamento da IA e níveis de raciocínio

Exemplos Básicos de Uso

# Programmatic usage
from ai_interaction_tool import ai_interaction

# Launch interactive interface
result = ai_interaction()
print(result)  # Structured output with tags

🖼️ Recursos de Anexo de Imagens

📷 Capacidades Principais de Imagem

Suporte a Arrastar e Soltar: Arraste imagens diretamente para a UI
Gerenciamento de Múltiplas Imagens: Anexar, pré-visualizar e remover múltiplas imagens
Formatos Suportados: PNG, JPG, JPEG, GIF, BMP, WEBP
Armazenamento Seguro: Imagens armazenadas com segurança no diretório user_images/
Codificação Base64: Conversão automática para processamento pela IA
Sistema de Pré-visualização: Clique nas imagens para ver versões maiores
Estado Persistente: Opção de salvar imagens com persistência da caixa de seleção

🎯 Como Usar o Anexo de Imagens

Botão Anexar: Clique em "📷 Anexar Imagens" para selecionar arquivos
Arrastar e Soltar: Arraste imagens do explorador de arquivos diretamente para a UI
Suporte a Colar: Cole imagens da área de transferência (Ctrl+V)
Múltiplas Imagens: Anexe quantas imagens forem necessárias
Remover Imagens: Clique no botão X nas pré-visualizações individuais
Limpar Tudo: Use "🗑️ Limpar Imagens" para remover todas de uma vez
Alternar Salvamento: Marque/desmarque "Salvar imagens" para controlar a persistência

🛡️ Segurança e Privacidade

Somente Local: Todas as imagens são armazenadas localmente em user_images/
Sem Acesso Externo: Sem uploads ou conexões externas
Caminhos Relativos: Apenas caminhos relativos são armazenados na configuração por segurança
Controle do Usuário: Os usuários controlam quais imagens anexar e salvar
Limpeza Automática: Imagens são limpas automaticamente quando o salvamento é desativado

Formato de Saída

O AI Interaction Tool usa formato limpo baseado em tags:

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>

Nota: Quando imagens são anexadas, elas são automaticamente convertidas para formato base64 e incluídas na resposta para processamento pela IA.

🔧 Solução de Problemas

Problemas Comuns

Erro "Comando não encontrado"
- Verifique se o Python está instalado e no PATH
- Verifique o caminho absoluto na configuração do MCP
Erro "Módulo não encontrado"
- Execute pip install -r requirements.txt
- Verifique o ambiente virtual, se estiver usando um
UI não exibindo
- Certifique-se de que o PyQt5 está instalado corretamente
- Verifique as configurações de exibição e o ambiente de desktop
Anexo de arquivo não funcionando
- Verifique as permissões de arquivo e direitos de acesso
- Verifique a configuração do caminho do workspace
🖼️ Problemas com anexo de imagens
- Certifique-se de que o PyQt5 está instalado corretamente para processamento de imagens
- Verifique as permissões do diretório user_images/
- Verifique os formatos de imagem: PNG, JPG, JPEG, GIF, BMP, WEBP suportados
- Limpe a configuração se as imagens não carregarem: Remova last_attached_images do config.json
Problemas de Conexão MCP no Cursor
- Verifique a configuração do servidor MCP nas configurações do Cursor
- Verifique se o processo está rodando com ps aux | grep mcp_server
- Reinicie o Cursor após alterações na configuração

Modo de Depuração

Para depurar problemas, execute o servidor diretamente:

python mcp_server.py

Para depuração no Cursor:

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

🔄 Histórico de Versões

v2.2.0 (Mais Recente): 🖼️ Sistema de Anexo de Imagens - Suporte completo a imagens com arrastar e soltar, gerenciamento de múltiplas imagens, melhorias de segurança e estado persistente
v2.1.0: UI/UX aprimorado, integração com Cursor IDE, sistema de configuração Debounce
v2.0.0: Arquitetura refatorada com UI moderna PyQt5
v1.x: Funcionalidade principal e recursos básicos

🎯 Alterações Detalhadas da v2.2.0:

✅ UI de Anexo de Imagens: Interface completa de arrastar e soltar com sistema de pré-visualização
✅ Suporte a Múltiplos Formatos: Compatibilidade com PNG, JPG, JPEG, GIF, BMP, WEBP
✅ Reforço de Segurança: Armazenamento seguro de caminhos, processamento somente local
✅ Gerenciamento de Banco de Dados: Limpeza automática, armazenamento persistente, gerenciamento de estado
✅ Melhorias de UX: Clique para ampliar, botões de remoção, persistência da caixa de seleção
✅ Desempenho: Carregamento otimizado de imagens com conversão base64
✅ Correções de Bugs: Persistência do estado da caixa de seleção, problemas de carregamento de configuração resolvidos

🎯 Fluxo de Trabalho de Integração e Arquitetura do Sistema

🔄 Fluxo de Integração Completo:

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

🧠 Sistema de Realce Cognitivo:

Modo Padrão: Pensamento de alto nível com 1+ blocos de pensamento
Modo Ultra-Realce: 10 modos cognitivos inovadores simultaneamente
- Modo Cognitivo Quântico
- Orquestração Meta-Cognitiva
- Simulação de Persona Especialista
- Processamento com Dilatação de Tempo
- Integração em Nível de Sistemas
- Modo de Preparação Psicológica
- Alocação Máxima de Recursos Cognitivos
- Modo de Autoteste Adversarial
- Padrões Obsessivos de Qualidade
- Modo de Inovação Inovadora

📊 Sistema de Tags de Saída:

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

💡 Recursos Avançados e Melhores Práticas

🎨 Melhorias de UI/UX:

Design Responsivo: Dimensionamento adaptativo com resolução mínima de 800x700
Suporte a Múltiplos Idiomas: Alternância perfeita EN/VI com configuração persistente
Estilização Moderna PyQt5: Sistema de cores semânticas com propriedades de botão
Arrastar e Soltar de Arquivos: Anexo intuitivo de arquivos com validação
Menu de Contexto: Operações com botão direito para gerenciamento de arquivos
Salvamento com Debounce: Persistência inteligente de configuração com otimização QTimer

🔧 Especificações Técnicas:

Python: 3.8+ necessário com dependências PyQt5
Memória: Mínimo de 512MB de RAM para componentes de UI
Armazenamento: ~50MB para instalação da ferramenta e configuração
Plataforma: Multiplataforma (Windows/macOS/Linux) com estilização nativa
Desempenho: Arquitetura orientada a eventos com uso mínimo de CPU

📈 Otimização de Desempenho:

Carregamento Preguiçoso: Componentes carregam apenas quando necessário
Configuração Eficiente: Baseada em JSON com compressão automática
Gerenciamento de Recursos: Limpeza adequada e gerenciamento de memória
Estratégia de Cache: Persistência do estado do workspace para inicialização mais rápida

🛡️ Segurança e Privacidade

🔒 Recursos de Segurança:

Processamento Local: Todas as operações de arquivo são somente locais, sem uploads
Validação de Caminhos: Verificações de segurança robustas para acesso a arquivos
Execução em Sandbox: A ferramenta roda em ambiente controlado
Sem Coleta de Dados: Zero telemetria ou transmissão externa de dados

🔐 Proteção de Privacidade:

Criptografia de Configuração: Configuração local com opções de armazenamento seguro
Controle de Acesso a Arquivos: Permissões de anexo de arquivos controladas pelo usuário
Isolamento do Workspace: Limites de projeto são aplicados
Trilha de Auditoria: Registro opcional para monitoramento de segurança

🌟 Requisitos do Sistema e Compatibilidade

💻 Requisitos Mínimos do Sistema:

OS: Windows 10+ / macOS 10.14+ / Ubuntu 18.04+
Python: 3.8 or higher
RAM: 512MB available
Storage: 100MB free space
Display: 1024x768 minimum resolution

🎯 Configuração Recomendada:

OS: Windows 11 / macOS 12+ / Ubuntu 20.04+
Python: 3.10+ with virtual environment
RAM: 2GB available  
Storage: 500MB free space
Display: 1920x1080 or higher
GPU: Optional for enhanced UI rendering

🔧 Matriz de Compatibilidade:

Componente	Versão	Status	Notas
Python	3.8-3.11	✅ Testado	Recomendado 3.10+
PyQt5	5.15+	✅ Necessário	Framework principal de UI
Claude Desktop	Mais Recente	✅ Otimizado	Integração MCP
Cursor IDE	Última versão	🚀 Recomendado	Desenvolvimento com foco em IA
VS Code	Qualquer	✅ Compatível	Opção alternativa de IDE

🤝 Contribuindo

Nota: Este é um repositório privado. Somente o proprietário tem acesso de push.

Para sugestões ou problemas:

Crie relatórios de problemas detalhados
Forneça etapas de reprodução
Inclua informações do sistema
Anexe logs ou capturas de tela relevantes

📚 Documentação e Recursos

📖 Arquivos de Documentação:

rule_for_ai_VI.txt - Regras de comportamento do agente em vietnamita
rule_for_ai_EN.txt - Regras de comportamento do agente em inglês
SYSTEM_PROMPT_Claude-4-sonnet-max.txt - Exemplo completo do prompt do sistema
pyproject.toml - Configuração do projeto e dependências

🔗 Links Úteis:

💡 Projetos Relacionados:

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

📄 Licença e Legal

📜 Licença:

MIT License

Copyright (c) 2025 DemonVN - AI Interaction Tool

⚖️ Notas Legais:

A ferramenta está em conformidade com os requisitos de processamento local
Nenhuma coleta de dados pessoais
Respeita a privacidade do usuário e a soberania dos dados
Compatível com políticas de segurança empresarial

🎯 Agradecimentos Especiais:

Equipe do Model Context Protocol pela interface padronizada
Ecossistema de integração do Claude Desktop
Equipe do Cursor IDE pelas ferramentas de desenvolvimento com foco em IA
Comunidade Python de código aberto
Testadores beta e primeiros adotantes

🔥 Inspiração:

Projeto inspirado pela necessidade de ferramentas de interação com IA sem interrupções, com princípios modernos de UX e arquitetura de nível profissional.

🚀 Boa codificação com AI Interaction Tool!

Para suporte, problemas ou solicitações de recursos, abra um problema no repositório do GitHub.