KaushalprajapatiKP/custom-MCP-servers
3.2
If you are the rightful owner of custom-MCP-servers and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This project implements a Custom MCP (Multi-tool Control Protocol) server using FastMCP, supporting various functionalities like notes management, weather search, news search, document ingestion, and integration with OpenAI GPT.
Tools
8
Resources
0
Prompts
0
Custom MCP Server with RAG & Tools
This project implements a Custom MCP (Multi-tool Control Protocol) server using FastMCP, supporting:
- Notes Management (Add / Read / Summarize Notes)
- Weather Search (via WeatherAPI)
- Brave News Search (via Brave API)
- Document Ingestion & RAG Queries (via GroundX)
- OpenAI GPT Integration for Summarization & RAG
Features
- Append, read, and summarize text notes locally
- Get real-time weather info
- Search current news headlines via Brave API
- Ingest PDFs and perform RAG-based semantic search using GroundX
- Supports OpenAI GPT (e.g.,
gpt-4o) for completions - Local MCP Inspector for testing/debugging
Installation
1. Using uv (Recommended)
uv lock
uv sync
2. Using pip
pip install -r requirements.txt
Environment Variables (.env)
OPENAI_API_KEY=your_openai_api_key
GROUNDX_API_KEY=your_groundx_api_key
WEATHER_API_KEY=your_weatherapi_key
BRAVE_API_KEY=your_brave_api_key
BUCKET_ID=your_groundx_bucket_id
Running the MCP Server
Development Mode (with Inspector UI)
mcp dev main.py
If you get authentication errors, run with:
DANGEROUSLY_OMIT_AUTH=true mcp dev main.py
Development Mode with claude desktop app:
mcp install main.py
mcp run main
Available Tools & Resources
| Tool Name | Description |
|---|---|
add_note(message) | Append note to local file |
read_notes() | Return all stored notes |
note_summary_prompt() | Generate a prompt to summarize notes using GPT |
brave_search_results(q) | Latest news via Brave Search API |
fetch_weather(city) | Real-time weather from WeatherAPI |
ingest_documents(path) | Upload PDF to GroundX knowledge base |
process_search_query(q) | Perform RAG search with OpenAI GPT completions |
search_doc_for_rag_context(q) | Retrieve context text for GPT queries |
API Example (via Inspector)
{
"tool": "fetch_weather",
"args": {
"city": "New York"
}
}
Example Workflow
uv sync
cp .env.example .env # setup .env file
mcp dev main.py # start MCP development server
Troubleshooting
Error: Connection Error - Missing Proxy Token
➡️ Solution: Use the URL provided or run:
DANGEROUSLY_OMIT_AUTH=true mcp dev main.py
License
MIT License © 2025 Your Name / Your Organization
Generated with ❤️ using MCP, GroundX, OpenAI.