Multi-Agent RAG MCP Server

Multi-Agent RAG MCP Server

A comprehensive multi-agent Retrieval-Augmented Generation (RAG) system built on the Model Context Protocol (MCP), featuring specialized AI microagents for legal document processing, deadline extraction, and strategic analytics.

🎯 Overview

This project implements an interconnected agentic ecosystem using MCP servers as the foundation for coordinating specialized AI agents. The system is designed for legal tech applications, particularly document intelligence and deadline management.

✨ Features

• Multi-Agent Architecture: Three specialized agents working in coordination
• Vector Storage: Supabase with pgvector for semantic search
• MCP Integration: Seamless integration with Claude Desktop
• Legal Document Processing: Specialized for Spanish legal notifications
• Strategic Analytics: Business intelligence and context analysis
• Zero-Input Strategy: 75% automation, 25% strategic oversight

🤖 Agents

1. Deadline Agent

Extracts and manages deadlines from Spanish legal documents with high accuracy.

Capabilities:

• Spanish legal text processing
• Deadline extraction and categorization
• Automated deadline tracking
• Legal notification parsing

2. Document Classification Agent

Automatically categorizes and classifies legal documents.

Capabilities:

• Multi-class document classification
• Metadata extraction
• Automated tagging
• Document type recognition

3. SmartContext Analytics Agent

Provides strategic business intelligence and contextual analysis.

Capabilities:

• Strategic analytics
• Business context extraction
• Cross-document insights
• Trend analysis

🏗️ Architecture

rag-mcp-server/
├── src/
│   ├── server.py              # Main MCP server
│   ├── agents/
│   │   ├── deadline_agent.py
│   │   ├── document_agent.py
│   │   └── smartcontext_agent.py
│   └── data_sources/
├── database/
│   └── schema.sql             # Database schema
├── docs/                      # Documentation
├── config/                    # Configuration files
├── data/                      # Data storage
└── tests/                     # Test files

🚀 Quick Start

Prerequisites

• Python 3.10+
• Supabase account
• Claude Desktop (for MCP integration)
• PostgreSQL with pgvector extension

Installation

1. Clone the repository

git clone https://github.com/yourusername/rag-mcp-server.git
cd rag-mcp-server

2. Create virtual environment

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies

pip install -r requirements.txt

4. Configure environment

cp .env.example .env
# Edit .env with your credentials

5. Initialize database

# Run the database schema (see docs for details)
psql -h your-supabase-host -U postgres -d your-database -f database/schema.sql

6. Configure Claude Desktop Edit your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "rag-server": {
      "command": "python",
      "args": ["/Users/yourusername/rag-mcp-server/src/server.py"],
      "env": {
        "SUPABASE_URL": "your_supabase_url",
        "SUPABASE_KEY": "your_supabase_key"
      }
    }
  }
}

7. Restart Claude Desktop

🛠️ Usage

The system can be used in two ways:

1. MCP Server (Claude Desktop Integration)

Once configured, the agents are available through Claude Desktop with the following tools:

Deadline Agent Tools

• extract_deadlines - Extract deadlines from legal documents
• list_deadlines - List all tracked deadlines
• search_deadlines - Search deadlines by criteria

Document Agent Tools

• classify_document - Classify document type
• index_document - Add document to vector store
• search_documents - Semantic document search

SmartContext Agent Tools

• analyze_context - Strategic context analysis
• extract_insights - Business intelligence extraction
• trend_analysis - Cross-document trend analysis

2. REST API Server (Frontend Integration)

The system also provides a FastAPI REST API for frontend applications:

# Run REST API server (for frontend)
python src/api_server.py

The API server runs on http://localhost:8000 with interactive documentation at http://localhost:8000/docs.

Key Features:

• Client Management - Create and manage client records
• Document Upload - Upload documents with automatic processing
• Data Retrieval - Query documents, deadlines, and analyses per client
• CORS Enabled - Ready for frontend integration

API Endpoints:

Client Management:

• POST /api/clients - Create new client
• GET /api/clients - List all clients
• GET /api/clients/{client_id} - Get client details
• PUT /api/clients/{client_id} - Update client
• DELETE /api/clients/{client_id} - Delete client (soft delete)

Document Operations:

• `P