🦅 Saqr-MCP

Name: 🦅 Saqr-MCP
Author: ahmedhassan456

@ahmedhassan456

About 🦅 Saqr-MCP

Saqr-MCP is a powerful Python application that implements the Model Context Protocol (MCP) to enable advanced AI assistant capabilities. It supports both local models through Ollama and cloud models through Groq, providing a flexible client-server architecture

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Saqr-MCP": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is 🦅 Saqr-MCP?

🦅 Saqr-MCP is a Python application that implements the Model Context Protocol (MCP) to enable advanced AI assistant capabilities. It supports both local models through Ollama and cloud models through Groq, providing a flexible client-server architecture with tools for web search, memory management, document generation, and advanced reasoning.

How to use 🦅 Saqr-MCP?

Install dependencies with UV, configure environment variables (API keys for Tavily, Groq, Mem0; Ollama model name), and run python main.py. Type queries in the interactive console; use quit to exit. To use Groq instead of Ollama, modify main.py to import from src.groq_client.

Key features of 🦅 Saqr-MCP

Interactive chat interface for querying models
Support for local models (Ollama) and cloud models (Groq)
Advanced web search capabilities using Tavily API
Word document generation from markdown content
Comprehensive memory management system using mem0
Advanced reasoning and thought process tracking

Use cases of 🦅 Saqr-MCP

Perform real-time web searches to retrieve up-to-date information
Create and manage persistent memories for context-aware interactions
Generate formatted Word documents from markdown content
Record and analyze reasoning processes during complex problem-solving
Switch between local and cloud models depending on availability or cost

FAQ from 🦅 Saqr-MCP

What are the prerequisites for using 🦅 Saqr-MCP?

Python 3.11 or higher, Ollama installed for local model usage, and the UV package manager (recommended).

What API keys are required and where do I get them?

You need a Tavily API key from app.tavily.com, a Groq API key from console.groq.com, and a Mem0 API key from mem0.ai. Configure them in a .env file based on .env.example.

How do I switch between local and cloud models?

By default the app uses Ollama. To use Groq, edit main.py to import SaqrMCPClient from src.groq_client instead of src.ollama_client.

What tools are available on the server?

Tools include web_search, word_file_generator, add_memory, get_all_memories, search_memories, think, get_thoughts, clear_thoughts, and get_thought_stats.

What is the project structure?

The entry point is main.py. The src/ folder contains ollama_client.py, groq_client.py, server.py, and logger.py.

Comments

More AI & Agents MCP servers

LinkedIn MCP Server

stickerdaniel

Open-source MCP server for LinkedIn. Give Claude and any MCP-compatible AI agent access to profiles, companies, jobs, and messages.

2.7K

Model Context Protocol for Unreal Engine

chongdashu

Enable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).

2.0K

欢迎来到智言平台

Shy2593666979

AgentChat 是一个基于 LLM 的智能体交流平台，内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作，Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术，实现高效的知识检索与工具调用，使用 FastAPI 构建高性能后端服务。

797