MCP-GROQ
by rahulsamant37·★ 1·Score 28
MCP-GROQ provides a suite of AI tools for search, mathematics, and news retrieval using MCP framework.
Overview
MCP-GROQ implements a microservices architecture using MCP to deliver specialized AI tools. The project includes three main tools: DuckDuckGo Search Engine for web search, Mathematical Operations Engine for arithmetic calculations, and Tech News Aggregator for retrieving technology news articles. Each tool operates through a client-server architecture leveraging large language models through Groq's API.
Try asking AI
After installing, here are 5 things you can ask your AI assistant:
When to choose this
Choose MCP-GROQ when you need lightweight search, math, or news tools integrated into an MCP-based system and already using Groq's LLM services.
When NOT to choose this
Avoid MCP-GROQ if you need enterprise-level reliability, higher performance alternatives, or tools outside its narrow scope of search, math, and news aggregation.
Tools this server exposes
3 tools extracted from the READMEduckduckgo_searchWeb search functionality via DuckDuckGo with content extraction
math_calculationBasic arithmetic operations with natural language processing
tech_news_retrievalLatest articles from Ars Technica with parsing and summarization
Comparable tools
Installation
Installation
- Install UV package manager:
curl -sSf https://install.ultraviolet.rs | sh
# or with pip
pip install uv- Clone and install dependencies:
git clone https://github.com/rahulsamant37/mcp-tools.git
cd mcp-tools
uv venv
source .venv/bin/activate # On macOS/Linux
uv pip sync- Create
.envfile with your Groq API key:
GROQ_API_KEY=your_groq_api_key_here- Install required MCP package and configure Claude Desktop:
uv pip install mcpAdd to Claude Desktop config:
{
"mcpServers": {
"groq-tools": {
"command": "python",
"args": ["-m", "mcp.server.groq-tools"],
"env": {
"GROQ_API_KEY": "your-api-key"
}
}
}
}FAQ
- How do I test individual tools?
- Each tool has its own client script. Run `python duckduckgo_client.py` for search, `python math_client.py` for calculations, and `python weather_client.py` for news.
- What is the architecture of this project?
- The project implements a microservices architecture with server layer for functionality, client layer for connections, and LLM integration using Groq's Qwen-2.5-32b model with ReAct methodology.
Compare MCP-GROQ with
Last updated · Auto-generated from public README + GitHub signals.