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

Related MCP server: Notes MCP Server

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

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.