Custom Server With RAG & Tools

БесплатноНе проверен

Enables notes management, weather and news search, document ingestion and RAG-based semantic search using GroundX, with OpenAI GPT integration for summarization

автор: KaushalprajapatiKP

GitHub Embed

Описание

Enables notes management, weather and news search, document ingestion and RAG-based semantic search using GroundX, with OpenAI GPT integration for summarization and completions.

README

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

Generated with ❤️ using MCP, GroundX, OpenAI.

from github.com/KaushalprajapatiKP/custom-MCP-servers

Установка Custom Server With RAG & Tools

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/KaushalprajapatiKP/custom-MCP-servers

FAQ