🏢 IMC Policy MCP Server

📋 Table of Contents

• 🎯 Overview
• ✨ Features
• 🏗️ Architecture
• 🚀 Quick Start
• ⚙️ Configuration
• 🔧 Development
• 🐳 Deployment
• 📊 Monitoring
• 🧪 Testing
• 📚 API Documentation

🎯 Overview

The IMC Policy MCP Server is a production-ready Model Context Protocol (MCP) server that provides intelligent insurance policy document retrieval using advanced Retrieval-Augmented Generation (RAG) techniques. Built with Spring AI 1.1.0-SNAPSHOT, it offers customer-scoped document search with enterprise-grade performance and security.

🎨 Key Highlights

graph TB
    A[🔍 MCP Client Query] --> B[🧠 Query Transformation]
    B --> C[🎯 Customer-Scoped Search]
    C --> D[📊 PGVector Similarity]
    D --> E[📄 Document Assembly]
    E --> F[✅ Structured Response]
    
    style A fill:#e1f5fe
    style B fill:#f3e5f5
    style C fill:#fff3e0
    style D fill:#e8f5e8
    style E fill:#fce4ec
    style F fill:#e3f2fd

✨ Features

🔥 Core Capabilities

| Feature | Description | Status | |---------|-------------|--------| | 🎯 Customer-Scoped RAG | Secure document retrieval filtered by customer ID | ✅ Production Ready | | 🧠 Query Rewriting | AI-powered query enhancement for better results | ✅ Configurable | | 🔍 Multi-Query Expansion | Generate diverse query variations | ✅ Optional | | 📊 PGVector Integration | High-performance vector similarity search | ✅ HNSW Index | | 🔧 MCP Tool Exposure | Standards-compliant tool interface | ✅ @McpTool | | 🚀 Auto-Configuration | Zero-config Spring Boot setup | ✅ Environment Aware | | 📄 PDF ETL Pipeline | Automated PDF processing with Tika and chunking | ✅ NEW | | 🔄 Re-Embedding Service | Update embeddings with new models | ✅ NEW | | 🔍 Debug & Diagnostics | Enhanced debugging and search testing tools | ✅ NEW |

🛡️ Enterprise Features

• 🔐 Security: Customer data isolation with metadata filtering
• 📈 Performance: Optimized vector search with configurable similarity thresholds
• 🔄 Scalability: Cloud Foundry and containerization support
• 📊 Monitoring: Comprehensive logging and health checks
• 🧪 Testing: Full test suite with disabled integration tests
• 📝 Documentation: Auto-generated API documentation

🏗️ Architecture

🏛️ System Architecture

graph TB
    subgraph "🌐 Client Layer"
        MC[MCP Client<br/>📱 Chat Interface]
    end
    
    subgraph "🎯 MCP Server"
        MT[McpToolService<br/>🛠️ @McpTool]
        RS[RagService<br/>🧠 Query Processing]
        QT[Query Transformers<br/>✨ AI Enhancement]
    end
    
    subgraph "💾 Data Layer"
        VS[VectorStore<br/>📊 PGVector]
        PG[(PostgreSQL<br/>🐘 + pgvec

... [View full README on GitHub](https://github.com/dbbaskette/imc-policy-mcp-server#readme)