Servidor MCP-RAG

MCP-RAG: Model Context Protocol with RAG 🚀

A powerful and efficient RAG (Retrieval-Augmented Generation) implementation using GroundX and OpenAI, built with Modern Context Processing (MCP).

🌟 Features

Advanced RAG Implementation: Utilizes GroundX for high-accuracy document retrieval
Model Context Protocol: Seamless integration with MCP for enhanced context handling
Type-Safe: Built with Pydantic for robust type checking and validation
Flexible Configuration: Easy-to-customize settings through environment variables
Document Ingestion: Support for PDF document ingestion and processing
Intelligent Search: Semantic search capabilities with scoring

🛠️ Prerequisites

Python 3.12 or higher
OpenAI API key
GroundX API key
MCP CLI tools

📦 Installation

Clone the repository:

git clone <repository-url>
cd mcp-rag

Create and activate a virtual environment:

uv sync
source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`

⚙️ Configuration

Copy the example environment file:

cp .env.example .env

Configure your environment variables in .env:

GROUNDX_API_KEY="your-groundx-api-key"
OPENAI_API_KEY="your-openai-api-key"
BUCKET_ID="your-bucket-id"

🚀 Usage

Starting the Server

Run the inspect server using:

mcp dev server.py

Document Ingestion

To ingest new documents:

from server import ingest_documents

result = ingest_documents("path/to/your/document.pdf")
print(result)

Performing Searches

Basic search query:

from server import process_search_query

response = process_search_query("your search query here")
print(f"Query: {response.query}")
print(f"Score: {response.score}")
print(f"Result: {response.result}")

With custom configuration:

from server import process_search_query, SearchConfig

config = SearchConfig(
    completion_model="gpt-4",
    bucket_id="custom-bucket-id"
)
response = process_search_query("your query", config)

📚 Dependencies

groundx (≥2.3.0): Core RAG functionality
openai (≥1.75.0): OpenAI API integration
mcp[cli] (≥1.6.0): Modern Context Processing tools
ipykernel (≥6.29.5): Jupyter notebook support

🔒 Security

Never commit your .env file containing API keys
Use environment variables for all sensitive information
Regularly rotate your API keys
Monitor API usage for any unauthorized access

🤝 Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Un servidor que implementa la generación aumentada de recuperación utilizando GroundX y OpenAI, lo que permite la búsqueda semántica y la recuperación de documentos con procesamiento de contexto moderno para un manejo mejorado del contexto.

Related MCP Servers

MCP Server for Vertex AI Search
ubie-oss
-
security
A
license
-
quality
A server that enables document searching using Vertex AI with Gemini grounding, improving search results by grounding responses in private data stored in Vertex AI Datastore.
Last updated 9 days ago
25
Python
Apache 2.0
RAG_MCP
mytechnotalent
-
security
-
license
-
quality
A Retrieval-Augmented Generation server that enables semantic PDF search with OCR capabilities, allowing users to query document content through any MCP client and receive intelligent answers.
Last updated 4 months ago
1
Python
Apache 2.0
MCP-RAG Server
sourangshupal
-
security
F
license
-
quality
Implements Retrieval-Augmented Generation (RAG) using GroundX and OpenAI, allowing users to ingest documents and perform semantic searches with advanced context handling through Modern Context Processing (MCP).
Last updated 4 months ago
4
Python
RAG-MCP Server
plaban1981
-
security
A
license
-
quality
A server that integrates Retrieval-Augmented Generation (RAG) with the Model Control Protocol (MCP) to provide web search capabilities and document analysis for AI assistants.
Last updated 3 months ago
3
Python
Apache 2.0

View all related MCP servers

MCP-RAG Server