\# AI交互工具 - MCP服务器
现代人工智能交互工具，配备先进用户界面和强大功能，支持模型上下文协议（MCP）
🚀 核心功能
🎯 主要功能
- 交互式用户界面弹窗 用于内容输入和对话控制
- 文件/文件夹附件 来自包含验证和预览的工作区
- 🖼️ 图片附件系统 支持拖放操作，多图像支持
- 多语言支持 （英文/越南文）
- 最大认知能力 激活以达到AI性能巅峰
- 基于标签的输出格式 与系统提示规则集成
- 工作区感知路径处理 为了跨项目的兼容性
🔧 v2.2.0（最新版）中的新功能
- 🖼️ 支持图片附件 具备拖放功能
- 🛡️ 安全增强 - 在user_images目录中安全存储路径
- 💾 持久化镜像状态 - �复选框状态保存正确
- 🎯 多图像管理 - 添加、预览和删除多张图片
- 🔄 数据库自动清理 - 禁用时自动清理图像
🔧 之前的版本 2.1.0
- 增强的用户界面/用户体验 配备现代PyQt5界面
- 基于结构化标签的输出 为了实现完美的AI代理集成
- 防抖配置 具备智能自动保存机制
- Cursor IDE 集成 附有全面的设置指南
📋 安装与设置指南
📥 步骤1：克隆仓库
git clone https://github.com/your-username/AI-interaction.git
cd AI-interaction🐍 步骤2：安装Python
- 要求Python 3.8+
- 从……下载 python.org（中文可表述为“Python官方网站”）
- 或者使用包管理器：
# Windows with Chocolatey
choco install python
# macOS with Homebrew
brew install python
# Ubuntu/Debian
sudo apt update && sudo apt install python3 python3-pip📦 步骤3：安装依赖项
# Using pip
pip install -r requirements.txt
# Or using uv (recommended for performance)
pip install uv
uv pip install -r requirements.txt⚙️ 步骤4：在Claude桌面配置MCP服务器
在Claude Desktop的配置文件中添加以下配置：
配置文件路径：
- Windows：
%APPDATA%\Claude\claude_desktop_config.json - macOS（苹果电脑操作系统）:
~/Library/Application Support/Claude/claude_desktop_config.json - Linux（发音为“林克斯”）:
~/.config/claude/claude_desktop_config.json
配置内容：
{
"mcpServers": {
"AI_interaction": {
"command": "python",
"args": ["E:/MCP-servers-github/AI-interaction/mcp_server.py"],
"stdio": true,
"enabled": true
}
}
}⚠️ 重要替换 E:/MCP-servers-github/AI-interaction/mcp_server.py 带有绝对路径到 mcp_server.py 在您的系统上。
🧠 第五步：配置AI代理规则（必填）
为了确保AI代理能够正常运行并使用ai_interaction工具，您必须设置自定义指令：
📋（清单/待办事项列表） 如何添加自定义指令：
- 打开Claude桌面版 或者访问Claude的网页界面
- 找到“自定义指令” 或者在设置中“添加自定义指令”
- 复制全部内容 来自其中一个规则文件：
- 🇻🇳 越南语： rule_for_ai_VI.txt - 🇺🇸 英语： rule_for_ai_EN.txt
- 粘贴到自定义说明中 字段并保存
🎯（靶心） 为何这是必要的：
- ✅ 行为框架规则定义了人工智能代理如何处理ai_interaction的输出
- ✅ 思考协议激活高级思维模式以获得高质量回应
- ✅ 超增强模式10种认知模式，助力性能最大化
- ✅ 标签处理读取并处理控制标签，如 ``
- ✅ 继续逻辑当（触发条件）时自动回忆ai_interaction
continue_chat=true
📁 代表文件夹的符号，可翻译为“文件夹”。 规则文件位置：
AI-interaction/
├── rule_for_ai_VI.txt # Vietnamese rules
├── rule_for_ai_EN.txt # English rules
└── ...⚡ 闪电符号（在中文语境中，此符号常被用作表情或表示快速、突然等含义，但无直接对应文字翻译，故保留原符号） 快速设置命令：
# 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🚀 第六步：配置 Cursor IDE（推荐）
Cursor 是推荐使用此工具进行AI开发的集成开发环境（IDE）：
📋（清单/待办事项列表） 光标设置步骤：
- 下载 Cursor： https://cursor.sh/ 翻译为中文可以是：“https://cursor.sh/（网站地址，可直接使用或根据上下文意译为‘光标工具网站’等，但通常网址保持原样）”。不过，通常在中文语境中，网址会保持原样不翻译，除非是为了说明其用途或进行意译以帮助理解。所以，简洁的翻译就是保留原网址
- 安装并打开工作区打开AI交互文件夹
- 在光标中配置MCP：
- 打开命令面板（Cmd/Ctrl + Shift + P） - 搜索“配置MCP服务器” - 添加AI交互服务器配置
- 设置自定义指令：
- 从（某处）复制内容 rule_for_ai_VI.txt 或者 rule_for_ai_EN.txt - 在自定义模式下，将内容粘贴到“自定义指令”字段中（Agent端）：
🎯（目标） 光标优势：
- ✅ 原生MCP支持内置与MCP服务器的集成
- ✅ 表示“正确”或“已完成” AI-First IDE（人工智能优先集成开发环境）针对AI开发工作流程进行了优化
- ✅ 实时建议上下文感知的代码补全
- ✅ 高级调试增强MCP工具的调试功能
- ✅ 演出对于AI项目，比传统集成开发环境（IDE）更快
🚀 第七步：启动并测试
!!! -----> 在你的终端中运行：python E:\\MCP-servers-github\\AI-interaction\\main.py --ui
⚠️ 重要替换 E:/MCP-servers-github/AI-interaction/mcp_server.py 带有绝对路径到 mcp_server.py 在您的系统上。 ---> 自动展UI（或：车展界面）
- 重启 Claude 桌面/Cursor 配置MCP服务器后
- 测试连接 通过打电话
ai_interaction工具 - 测试UI弹窗 验证功能
- 验证规则集成 通过人工智能代理的响应
📦 包结构
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🎮 使用指南
MCP服务器中可用的工具
1. 人工智能交互主要交互工具
- 功能创建带有文件/图片附件的用户输入UI弹窗
- 输出基于标签的结构化格式，支持图像
- 集成与系统提示规则完美集成
- 用例：
- 输入带格式的复杂内容 - 从工作区附加文件/文件夹 - 🖼️ 通过拖放功能附加图片 - 📷 支持多图浏览与管理 - 控制人工智能的思考模式和推理层次
基本使用示例
# Programmatic usage
from ai_interaction_tool import ai_interaction
# Launch interactive interface
result = ai_interaction()
print(result) # Structured output with tags🖼️ 图片附件功能
📷（相机图标，通常表示拍照或相机功能） 核心图像功能
- 拖放支持直接将图像拖放到用户界面中
- 多图像管理附加、预览和删除多张图片
- 格式支持PNG、JPG、JPEG、GIF、BMP、WEBP
- 安全存储安全存储的图像
user_images/目录 - Base64 编码自动转换以供AI处理
- 预览系统点击图片查看大图
- 持久状态保存图像选项，带有复选框持久性
🎯（目标） 如何使用图片附件
- 附加按钮点击“📷 附加图片”以选择文件
- 拖放直接从文件资源管理器拖动图像到用户界面
- 粘贴支持从剪贴板粘贴图像（Ctrl+V）
- 多张图片根据需要附上尽可能多的图片
- 删除图片点击单个图片预览上的X按钮
- 清除全部使用“🗑️ 清除图片”一次性删除所有图片
- 保存切换（或“保存/取消保存”）勾选/取消勾选“保存图片”以控制持久性
🛡️ 翻译成中文是“盾牌”。 安全与隐私
- 仅限本地所有图像均本地存储在
user_images/ - 无外部访问权限不支持上传或外部连接
- 相对路径仅在配置中存储相对路径以确保安全
- 用户控制用户控制要附加和保存哪些图像
- 自动清理当禁用保存时，图像自动清理
输出格式
AI交互工具采用简洁的标签化格式：
User message content with natural line breaks
FOLDERS:
- workspace_name/relative/path/to/folder
FILES:
- workspace_name/relative/path/to/file.js
workspace_name
true/false注当附加图像时，它们会自动转换为base64格式，并包含在响应中以供AI处理。
🔧 故障排除
常见问题
- “命令未找到”错误
- 检查是否已安装Python并已将其添加到PATH中 - 验证MCP配置中的绝对路径
- “模块未找到”错误
- 跑 pip install -r requirements.txt - 如果使用了虚拟环境，请检查它
- 用户界面未显示
- 确保PyQt5已正确安装 - 检查显示设置和桌面环境
- 文件附件无法正常工作
- 验证文件权限和访问权限 - 检查工作区路径配置
- 🖼️ 图片附件问题
- 确保PyQt5已正确安装以用于图像处理 - 检查 user_images/ 目录权限 - 验证图像格式：支持PNG、JPG、JPEG、GIF、BMP、WEBP - 如果图片无法加载，请清除配置：删除 last_attached_images 来自 config.json
- 游标中的MCP连接问题
- 在Cursor设置中验证MCP服务器配置 - 检查正在运行的进程 ps aux | grep mcp_server - 配置更改后重启光标
调试模式
为调试问题，请直接运行服务器：
python mcp_server.py用于Cursor调试：
# Check MCP server logs in Cursor
# Open Developer Tools → Console
# Look for MCP connection messages🔄 版本历史
- 版本2.2.0 （最新）：🖼️ 图像附件系统 - 完整的图像支持，包括拖放功能、多图像管理、安全增强以及持久化状态
- v2.1.0（版本2.1.0）增强的用户界面/用户体验，光标集成到IDE，防抖配置系统
- v2.0.0重构了架构，采用了现代的PyQt5用户界面
- v1.x核心功能和基本特性
🎯（目标） v2.2.0 详细变更内容：
- ✅ 图片附件用户界面带有预览系统的完整拖放界面
- ✅ 多格式支持PNG、JPG、JPEG、GIF、BMP、WEBP 格式兼容
- ✅ 安全加固安全路径存储，仅本地处理
- ✅ 数据库管理自动清理、持久化存储、状态管理
- ✅ 用户体验改进点击放大，移除按钮，复选框持久性保存
- ✅ 演出优化图像加载，采用Base64编码转换
- ✅（对号，表示正确、确认或完成） 错误修复复选框状态持久化、配置加载问题已解决
🎯 集成工作流程与系统架构
🔄 旋转（循环） 完整集成流程：
[User Input] → [ai_interaction Tool] → [Tag-based Output] → [AI Agent Rules] → [Enhanced Response]
↑ ↓
└─────────────── [Auto-recall if continue_chat=true] ←─────────────────────────┘🧠 这个表情符号通常表示“大脑”或“思考”，可以翻译为“思考中”或“动动脑筋”。 认知增强系统：
- 标准模式采用1+思维模块进行高级思维
- 超增强模式同时突破10种认知模式
- 量子认知模式 - 元认知协调 - 专家角色模拟 - 时间膨胀处理 - 系统级集成 - 心理启动模式 - 最大认知资源分配 - 对抗性自测模式 - 极致质量标准 - 突破性创新模式
📊（图表/数据） 输出标签系统：
true/false
FOLDERS:
- workspace_name/relative/path/folder
FILES:
- workspace_name/relative/path/file.ext
workspace_name💡 高级功能与最佳实践
🎨 表示“美术”或“艺术创作”的符号。 UI/UX改进：
- 响应式设计自适应尺寸调整，最低分辨率为800x700
- 多语言支持无缝的英/中（EN/VI）切换，配置持久保存
- 现代PyQt5样式设计具有按钮属性的语义色彩系统
- 文件拖放直观的文件附件功能，带验证
- 上下文菜单文件管理的右键操作
- 防抖保存使用 QTimer 优化的智能配置持久化
🔧 修理工具或螺丝刀的符号（在中文语境中，这个符号本身没有直接的翻译，通常根据上下文理解为表示修理、工具或螺丝刀的意思）。 技术规格：
- python需要3.8+版本，并包含PyQt5依赖项
- 记忆用户界面组件至少需要512MB内存
- 存储~50MB 用于工具安装和配置
- 平台跨平台（Windows/macOS/Linux），具备原生风格
- 演出事件驱动架构，CPU使用率最低
📈 表示“上升趋势”或“增长”，在图表中通常用向上的箭头来表示数据或价格的上升。 性能优化：
- 懒加载组件仅在需要时加载
- 高效配置基于JSON，支持自动压缩
- 资源管理适当的清理和内存管理
- 缓存策略工作区状态持久化，实现更快启动
🛡️ 安全与隐私
🔒（锁形图标，通常表示安全、保密或锁定状态） 安全特性：
- 本地处理所有文件操作仅限本地进行，不进行上传
- 路径验证针对文件访问的强健安全检查
- 沙盒执行工具在受控环境中运行
- 不收集数据无遥测或外部数据传输
🔐 隐私保护：
- 配置加密带有安全存储选项的本地配置
- 文件访问控制用户控制的文件附件权限
- 工作区隔离项目边界得到严格执行
- 审计追踪（或审计轨迹）用于安全监控的可选日志记录
🌟 系统要求与兼容性
💻 电脑 最低系统要求：
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🎯（瞄准靶心） 推荐设置：
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🔧 修理工具（或表示修理、维护的意思，具体根据上下文确定） 兼容性矩阵：
| 组件 | 版本 | 状态 | 备注 |
|---|---|---|---|
| Python | 3.8-3.11 | ✅ 已测试 | 推荐使用 3.10+ |
| PyQt5 | 5.15+ | ✅ 必需 | 核心用户界面框架 |
| Claude Desktop | 最新版本 | ✅ 已优化 | MCP 集成 |
| Cursor 集成开发环境 (IDE) | 最新的 | 🚀 推荐 | 以人工智能为先的发展 |
| VS Code | 任意 | ✅ 兼容 | 替代IDE选项 |
🤝 贡献
注这是一个私有仓库。只有仓库所有者有推送权限。
对于建议或问题：
- 创建详细的报告问题
- 提供复现步骤
- 包含系统信息
- 附上相关日志或截图
📚 文档与资源
📖（书本） 文档文件：
rule_for_ai_VI.txt- 越南代理行为规范rule_for_ai_EN.txt- 英文代理行为规则SYSTEM_PROMPT_Claude-4-sonnet-max.txt- 完整系统提示示例pyproject.toml- 项目配置和依赖项
🔗 有用链接：
💡（这个符号本身在中文里没有直接对应的翻译，它通常代表“灯泡”或“灵感”的意思，可以理解为“灵光一闪”或“有了想法”。） 相关项目：
📄 许可证与法律事项
📜（文件、文档的象征符号） 许可证：
MIT License
Copyright (c) 2025 DemonVN - AI Interaction Tool⚖️ 法律备注：
- 该工具符合本地处理要求
- 不收集个人数据
- 尊重用户隐私和数据主权
- 与企业安全策略兼容
🎯（瞄准目标） 特别感谢：
- 模型上下文协议团队（负责标准化接口）
- Claude桌面集成生态系统
- Cursor IDE团队致力于打造AI优先的开发工具
- 开源Python社区
- 测试版用户和早期采用者
🔥 火焰符号，可直接用作表情或表示“热门”、“火爆”等含义，无直接文字对应，故在此保留原符号形式。 灵感来源：
该项目受现代用户体验原则与专业级架构需求的启发，旨在打造无缝衔接的人工智能交互工具。
______________________________________________________________________
🚀 用AI交互工具快乐编码！
*如需支持、报告问题或提出功能请求，请在GitHub仓库上提交一个议题。*