MCP-GROQ
Delivers latest articles from Ars Technica with content parsing and summarization.
Provides web search functionality through DuckDuckGo, including content extraction and rate-limited requests.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP Tools Project
Overview
This project implements a suite of AI tools built on the Machine Communication Protocol (MCP) framework. Each tool leverages large language models through a client-server architecture to provide specialized functionality for search, mathematics, and news retrieval operations.
Related MCP server: MCP Toolbox
Features
DuckDuckGo Search Engine: Web search with content extraction capabilities
Mathematical Operations Engine: Basic arithmetic with natural language processing
Tech News Aggregator: Real-time technology news from reputable sources
Requirements
Python 3.8+
UV package manager
Groq API key
Installation
Setting up UV
If you don't have UV installed, install it first:
# Install UV using curl
curl -sSf https://install.ultraviolet.rs | sh
# Or with pip
pip install uvInstalling Project Dependencies
Clone the repository and install dependencies using the existing pyproject.toml:
# Clone the repository
git clone https://github.com/rahulsamant37/mcp-tools.git
cd mcp-tools
# Create and activate a virtual environment
uv venv
# On Windows:
.venv\Scripts\activate
# On macOS/Linux:
source .venv/bin/activate
# Install dependencies from pyproject.toml
uv pip syncIf you need to install dependencies without an existing pyproject.toml:
# Install directly (will update pyproject.toml and uv.lock)
uv pip install mcp langchain-mcp-adapters langchain-groq langgraph httpx beautifulsoup4 python-dotenvEnvironment Configuration
Create a .env file in the project root:
GROQ_API_KEY=your_groq_api_key_hereUsage Guide
Each tool can be tested independently by running its client script, which automatically launches the corresponding server component.
DuckDuckGo Search Tool
python duckduckgo_client.pyThis tool provides:
Web search functionality via DuckDuckGo
Content extraction from websites
Rate-limited requests to prevent IP blocking
Formatted search results optimized for LLM consumption
Math Calculation Tool
python math_client.pyThis tool enables:
Basic arithmetic operations (addition, multiplication)
Natural language processing of mathematical expressions
Integration with ReAct agents for complex problem solving
Tech News Retrieval Tool
python weather_client.pyThis tool delivers:
Latest articles from Ars Technica
Content parsing and summarization
Structured data output for LLM processing
Technical Architecture
The project implements a microservices architecture using MCP:
Server Layer
Implements domain-specific functionality
Exposes capabilities through standardized MCP interfaces
Handles rate limiting and error management
Processes raw data into LLM-friendly formats
Client Layer
Establishes connections to server components
Creates LangChain-compatible tool interfaces
Integrates with ReAct agents for reasoning
Manages conversation context and state
LLM Integration
Leverages Groq's Qwen-2.5-32b model for reasoning
Implements ReAct (Reasoning + Acting) methodology
Supports asynchronous operations for improved performance
Troubleshooting
Issue | Solution |
Connection errors | Check that no other processes are using required ports |
Authentication failures | Verify Groq API key in .env file |
Rate limiting | Implement exponential backoff between requests |
Timeout errors | Increase timeout values in httpx client configurations |
Dependency issues | Run |
UV sync errors | Check if pyproject.toml exists and is valid |
Contributing
To extend this project with new tools:
Create a server file implementing your tool's functionality
Expose methods using the
@mcp.tool()decoratorDevelop a client file that establishes connections and loads tools
Integrate with the ReAct agent framework
License
This project is licensed under the GNU License - see the LICENSE file for details.
Acknowledgments
langchain-mcp-adapters framework
Groq for LLM API access
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Scrape, crawl and search the web for AI agents via MCP.
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Live AI-native web search with citations. One tool for every MCP client. Flat per-request pricing.
A hosted MCP suite providing workflow primitives: web search, content fetching, compression, deduplication, cost/budget management, and agent memory pipelines.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP server for xAI Grok API with 19 tools for chat, web and X search, session management, tool chaining, image and video generation, and documentation.2MIT
- FlicenseNot gradedqualityDmaintenanceProvides a versatile set of utility tools for LLMs, including text processing, web fetching, and search capabilities, all accessible via MCP.-
- AlicenseAqualityBmaintenanceA Grok-first multi-source search MCP for AI agents that integrates Grok, Tavily, AnySearch, and Firecrawl to provide unified search results, cross-verification, and web content fetching.4MIT
- AlicenseAqualityCmaintenanceProvides MCP tools to fetch and search AI, Malaysian, and Germany SWE job-market news briefings, retrieve article content and Hacker News discussions, and perform web search and deep research.8MIT