🦅 Saqr-MCP

✨ 功能

• 🤖 用于查询模型的交互式聊天界面
• 🔄 支持本地模型（Ollama）和云端模型（Groq）
• 🔍 使用 Tavily API 实现高级网络搜索功能
• 📝 根据 Markdown 内容生成 Word 文档
• 🧠 使用 mem0 实现全面的记忆管理系统
• 💭 高级推理和思维过程跟踪
• ⚡ 异步架构，实现高效处理
• 🎨 视觉加载动画，提升用户体验
• 📊 基于会话的思维记录和分析
• 📄 支持 Markdown 的文档生成

📋 前置条件

• 🐍 Python 3.11 或更高版本
• 🦙 已安装 Ollama 和本地模型（用于使用本地模型）
• 📦 UV 包管理器（推荐）

🚀 安装

1. 克隆此仓库：

   git clone https://github.com/ahmedhassan456/Saqr-MCP.git
   cd saqr-mcp
   

2. 创建并激活虚拟环境（可选，但推荐）：

   uv venv
   # On Windows
   .venv\Scripts\activate
   # On Unix or MacOS
   source venv/bin/activate
   

3. 安装依赖：

   uv add -r requirements.txt
   

4. 设置环境变量：

   • 将 .env.example 复制为 .env
   • 配置以下变量：
     • 🔑 MODEL_NAME：首选的 Ollama 模型（例如，qwen3:1.7b）
     • 🔍 TAVILY_API_KEY：从 Tavily 网站获取的 Tavily API 密钥
     • ⚡ GROQ_MODEL_NAME：首选的 Groq 模型名称
     • 🔐 GROQ_API_KEY：从 Groq 网站获取的 Groq API 密钥
     • 🧠 MEM0_API_KEY：从 Mem0 网站获取的 Mem0 API 密钥

💻 使用方法

1. 使用本地模型时，请确保 Ollama 正在运行，并且已提供所选模型

2. 配置客户端：

   • 默认情况下，应用使用 Ollama 客户端（from src.ollama_client import SaqrMCPClient）
   • 若要改用 Groq，请修改 main.py，使用 from src.groq_client import SaqrMCPClient

3. 运行客户端：

   python main.py
   

4. 在交互式控制台中输入查询：

   MCP Client Started!
   Type your queries or 'quit' to exit.
   
   Query:
   

5. 输入 quit 退出应用程序

📁 项目结构

• 📄 main.py - 启动 MCP 客户端的入口文件
• 📂 src/
  • 🔄 ollama_client.py - Ollama 模型的 MCP 客户端实现
  • ⚡ groq_client.py - Groq 模型的 MCP 客户端实现
  • 🛠️ server.py - 实现所有工具的 MCP 服务
  • 📝 logger.py - 带有视觉动画的自定义日志工具

🛠️ 可用工具

该服务实现了一套全面的工具，可提供各种功能：

🔍 网络搜索和文档生成

• web_search：使用 Tavily API 执行实时网络搜索，获取最新信息
• word_file_generator：根据 Markdown 内容创建格式规范的 Microsoft Word 文档

🧠 记忆管理

• add_memory：将指定类型和内容的新记忆存储到 mem0
• get_all_memories：检索所有已存储的记忆，可按类型筛选
• search_memories：对已存储的记忆进行语义搜索，以查找相关信息

💭 推理与思考过程

• think：记录复杂问题解决过程中的想法和推理过程
• get_thoughts：获取当前会话中记录的所有想法
• clear_thoughts：清除当前会话中记录的所有想法
• get_thought_stats：提供已记录想法的详细统计信息

⚙️ 环境变量

变量	描述	默认值
🔑 OLLAMA_MODEL_NAME	要使用的 Ollama 模型名称（例如，qwen3:1.7b）	无
🔍 TAVILY_API_KEY	用于网页搜索功能的 Tavily API 密钥	无
⚡ GROQ_MODEL_NAME	要使用的 Groq 模型名称	无
🔐 GROQ_API_KEY	用于访问云端模型的 Groq API 密钥	无
🧠 MEM0_API_KEY	用于内存管理的 Mem0 API 密钥	无

📦 依赖项

• 🔄 mcp[cli] - Model Context Protocol 实现
• 🌐 httpx - 用于 Python 的 HTTP 客户端
• 📝 loguru - 简化 Python 日志记录
• ⚡ groq - Groq API 客户端
• 🦙 ollama - 用于访问本地模型的 Ollama 接口
• 🔍 tavily-python - 专为 AI Agent 设计的搜索引擎
• 🚀 fastapi - 用于构建 API 的 Web 框架
• ⚡ uvicorn - ASGI 服务实现
• 📄 htmldocx - HTML 转 DOCX 转换器
• 🔍 duckduckgo-search - 搜索引擎集成
• 📄 python-docx - DOCX 文件处理
• 📝 markdown - Markdown 处理
• 🧠 mem0 - 内存管理系统

📄 许可证

MIT

🤝 贡献

欢迎贡献！欢迎提交 Pull Request。

1. 🍴 Fork 此仓库
2. 🌿 创建功能分支（git checkout -b feature/amazing-feature）
3. 💾 提交更改（git commit -m 'Add some amazing feature'）
4. 📤 将分支推送到远程仓库（git push origin feature/amazing-feature）
5. 🔄 发起 Pull Request