使用说明
🧠 NeuroMail——情境感知电子邮件和文件助手
NeuroMail是一款基于人工智能的桌面助手，可帮助您使用本地大型语言模型（LLM）搜索文件、阅读文档和发送电子邮件。
它结合了：
🦙 Ollama（本地人工智能模型）
🔌 模型上下文协议（MCP）
🌐 流线型UI
📁 本地文件系统访问
📧 电子邮件自动化
NeuroMail的目标是通过自然语言使您的计算机文件和电子邮件系统易于理解。
例子：
“查找我的笔记文件并对其进行总结” “阅读report.txt” “将此文件摘要发送给我的教授”
🚀 这个项目做什么
NeuroMail包含两个协同工作的主要程序。
1.️⃣ Streamlit客户端（Streamlit_app.py）
这是前端AI聊天界面。
它提供：
✅ 基于聊天的用户界面 ✅ 与当地Olama车型的连接 ✅ 通过MCP调用工具 ✅ 流式AI响应 ✅ 通过自然语言进行文件和电子邮件交互
这里发生了什么？
用户在聊天中键入消息。
AI模型分析请求。
如果需要，它会请求一个工具（文件搜索、读取文件、电子邮件）。
该工具通过MCP服务器运行。
结果将返回并汇总给用户。
因此，此文件的行为如下：
👉 大脑+用户界面
主要特点
ChatGPT风格界面
从当地Ollama车型中选择车型
温度和令牌控制
MCP工具状态监测
故障排除调试面板
流式响应（实时打字）
2.️⃣ MCP服务器（MCP_Server.py）
这是后端工具服务器。
它安全地允许AI与您的计算机进行交互。
把它想象成：
👉 人工智能之手
MCP服务器提供的工具 📁 文件搜索
搜索内部文件：
~/文档/神经邮件
例子：
查找包含“报告”的文件 📄 读取文件
安全地读取文件内容。
例子：
阅读notes.txt 📂 列出文件
显示NeuroMail目录中的文件夹和文件。
例子：
显示所有文件 📧 发送电子邮件
使用SMTP发送电子邮件（支持Gmail）。
例子：
将摘要发送到someone@example.com 🔒 安全特性
AI无法访问Neuromail文件夹外的文件
路径验证阻止系统访问
忽略隐藏的临时/日志文件
安全的环境变量电子邮件登录
🧩 两个程序如何协同工作 用户 ↓ 流媒体聊天界面 ↓ 当地LLM（Ollama） ↓ MCP工具请求 ↓ MCP服务器 ↓ 文件系统/电子邮件 ↓ 结果→ AI摘要→ User
简单的想法：
👉 AI决定做什么 👉 MCP服务器执行如何操作
📁 项目文件夹结构 NeuroMail 的 │ ├── streamlit_app.py#聊天界面 ├── mcp_server.py#mcp后端服务器 ├── .env#电子邮件凭据 └── README.md ⚙️ 需求
安装Python包：
pip安装streamlit olama mcp python dotenv
从以下位置安装Olama： https://ollama.com
拉一个模型：
奥拉玛拉米斯特拉尔 ▶️ 如何运行项目 步骤1--创建Neuromail文件夹
创建：
文件/神经邮件
将您希望AI访问的文件放在此处。
步骤2——设置电子邮件（可选）
创建.env文件：
电子邮件用户=your_email@gmail.com 电子邮件地址=your_app_password SMTP_SERVER=SMTP.gmail.com SMTP_PORT=587 步骤3--运行应用程序 streamlit运行streamlit_app.py
浏览器将自动打开。
💬 示例命令
试着问：
“列出我的文件”
“搜索笔记”
“读取项目.txt”
“汇总此文件”
“发送包含此内容的电子邮件”
🐛 调试面板
该应用程序包括一个调试部分，显示：
Python 版本
MCP连接状态
加载的工具
基本目录
可用文件
如果有些东西不起作用，会很有帮助。
🎯 为什么这个项目很强大
大多数AI助手无法安全地访问本地文件。
NeuroMail通过使用模型上下文协议（MCP）解决了这个问题，该协议允许：
✅ 受控工具使用 ✅ 安全的本地自动化 ✅ 真正的AI+真正的行动
这使当地的法学硕士成为个人生产力助理。
🔮 未来改进（想法）
Google Drive集成
日历排程
语音命令
文件摘要存储器
多用户配置文件
自动电子邮件起草
👨💻 作者
NeuroMail——使用MCP+本地LLM的上下文感知电子邮件和文件自动化。
