first commit

README.md

@@ -0,0 +1,385 @@
+# **IntegraChat — Multi-Tenant Autonomous MCP Platform**
+
+### **Enterprise-grade AI with autonomous agents, secure multi-tenant RAG, real-time web search, red-flag governance, and analytics.**
+
+---
+
+## **📌 Overview**
+
+**IntegraChat** is an enterprise-ready, multi-tenant AI platform built to demonstrate the full capabilities of the **Model Context Protocol (MCP)** in a real production-style environment.
+
+It combines **autonomous tool-using agents**, **RAG retrieval**, **live web search**, and **admin governance** under strict **tenant isolation**, powered by Groq's **Llama-3.1-8B**.
+
+IntegraChat is a complete "**MCP in Action**" ecosystem — ideal for enterprise demos, research, production scaffolds, and governance-focused AI deployments.
+
+---
+
+# **🎯 Purpose**
+
+IntegraChat showcases how MCP can power **intelligent, governed, multi-tenant AI systems** with real-world requirements:
+
+* Isolation & access control
+* Compliance & red-flag detection
+* Tool-aware autonomous reasoning
+* RAG + web search hybrid AI
+* Analytics & observability
+* Admin governance workflows
+
+---
+
+# **🧩 Key Features**
+
+## **1. Autonomous MCP Agents**
+
+Agents can:
+
+* Analyze user intent
+* Detect sensitive or unsafe content
+* Dynamically select tools (RAG, Web, Admin, etc.)
+* Retrieve tenant-private knowledge
+* Pull real-time data from the internet
+* Trigger admin alerts
+* Respond using Groq's **Llama-3.1-8B**
+
+## **2. Enterprise RAG System**
+
+* MiniLM embeddings
+* Supabase + pgvector
+* Strict multi-tenant RLS enforcement
+* PDF / DOCX / TXT / URL ingestion
+* Chunking + semantic search
+
+## **3. Live Web Search Tool**
+
+* Real-time news
+* General web search
+* Fact-checking & fresh data retrieval
+
+## **4. Red-Flag Governance Engine**
+
+Admins configure rules to:
+
+* Block unsafe queries
+* Log violations
+* Trigger admin alerts
+
+Examples: `salary`, `delete all data`, `confidential client info`.
+
+## **5. Analytics Dashboard**
+
+Includes insights for:
+
+* Query volume
+* Tool usage
+* RAG performance
+* Red-flag violations
+* Agent reasoning traces
+* Tenant activity
+
+## **6. Multi-Tenant Isolation**
+
+Each tenant gets:
+
+* Private agents
+* Private knowledge base
+* Private admin rules
+* Private analytics
+
+Isolation is guaranteed via **Supabase RLS**.
+
+---
+
+# **🛠 Technology Stack**
+
+## **Backend**
+
+* FastAPI
+* MCP Client + MCP Servers
+* Supabase (Auth + Storage + pgvector)
+* MiniLM Embeddings
+* Groq Llama-3.1-8B
+* DuckDuckGo Search
+* Slack / Email alerting
+
+## **Frontend**
+
+* React 18
+* TailwindCSS
+* Zustand
+* WebSocket streaming
+* Admin dashboard + analytics
+
+---
+
+# **🧱 System Architecture**
+
+```
+Frontend (React)
+
+ - Chat UI
+
+ - Admin Panel
+
+ - Analytics / Insights
+
+ - WebSocket streaming
+
+
+
+MCP Client (FastAPI)
+
+ - Intent handling
+
+ - Red-flag scanning
+
+ - Tool selection logic
+
+ - Calls Groq Llama-3.1
+
+ - Event logging
+
+
+
+MCP Servers:
+
+ - RAG Server (private knowledge)
+
+ - Web Search Server (live data)
+
+ - Admin Server (alerts / governance)
+
+
+
+Database:
+
+ - Supabase (Auth + Storage + pgvector + RLS)
+```
+
+---
+
+# **📁 Project Structure**
+
+```
+IntegraChat/
+├── backend/
+│   ├── api/
+│   │   ├── main.py
+│   │   ├── routes/
+│   │   │   ├── agent.py
+│   │   │   ├── rag.py
+│   │   │   ├── web.py
+│   │   │   ├── admin.py
+│   │   │   └── analytics.py
+│   │   ├── services/
+│   │   │   ├── agent_orchestrator.py
+│   │   │   ├── intent_classifier.py
+│   │   │   ├── redflag_detector.py
+│   │   │   ├── tool_selector.py
+│   │   │   ├── prompt_builder.py
+│   │   │   └── llm_client.py
+│   │   ├── mcp_clients/
+│   │   │   ├── rag_client.py
+│   │   │   ├── web_client.py
+│   │   │   └── admin_client.py
+│   │   ├── models/
+│   │   │   ├── requests.py
+│   │   │   ├── responses.py
+│   │   │   ├── agent_decision.py
+│   │   │   └── embeddings.py
+│   │   ├── utils/
+│   │   │   ├── logging.py
+│   │   │   ├── supabase_client.py
+│   │   │   ├── tenant_context.py
+│   │   │   └── security.py
+│   │   └── config.py
+│   │
+│   ├── mcp_servers/
+│   │   ├── rag_server/
+│   │   │   ├── main.py
+│   │   │   ├── chunker.py
+│   │   │   ├── search.py
+│   │   │   ├── embeddings.py
+│   │   │   ├── ingestion/
+│   │   │   │   ├── ingest_pdf.py
+│   │   │   │   ├── ingest_docx.py
+│   │   │   │   ├── ingest_txt.py
+│   │   │   │   └── ingest_url.py
+│   │   │   ├── db/
+│   │   │   │   ├── documents_repo.py
+│   │   │   │   └── embeddings_repo.py
+│   │   │   └─�� config.py
+│   │   │
+│   │   ├── web_server/
+│   │   │   ├── main.py
+│   │   │   ├── providers/
+│   │   │   │   ├── ddg.py
+│   │   │   │   ├── serpapi.py (optional)
+│   │   │   │   └── bing.py (optional)
+│   │   │   └── utils.py
+│   │   │
+│   │   └── admin_server/
+│   │       ├── main.py
+│   │       ├── redflag_rules.py
+│   │       ├── alerts/
+│   │       │   ├── slack.py
+│   │       │   ├── email.py
+│   │       │   └── webhook.py
+│   │       └── audit_logs.py
+│   │
+│   ├── workers/
+│   │   ├── ingestion_worker.py
+│   │   ├── analytics_worker.py
+│   │   ├── scheduler.py
+│   │   └── celeryconfig.py
+│   │
+│   ├── tests/
+│   │   ├── test_agent.py
+│   │   ├── test_rag.py
+│   │   ├── test_admin.py
+│   │   ├── test_web.py
+│   │   └── test_end_to_end.py
+│   │
+│   └── Dockerfile
+│
+├── frontend/
+│   ├── src/
+│   │   ├── components/
+│   │   │   ├── chat/ChatWindow.jsx
+│   │   │   ├── chat/MessageBubble.jsx
+│   │   │   ├── chat/ToolTraces.jsx
+│   │   │   ├── admin/RedFlagEditor.jsx
+│   │   │   ├── admin/TenantManager.jsx
+│   │   │   ├── analytics/QueryStats.jsx
+│   │   │   ├── analytics/ToolUsageChart.jsx
+│   │   │   └── analytics/RagEffectiveness.jsx
+│   │   ├── pages/
+│   │   │   ├── ChatPage.jsx
+│   │   │   ├── AdminPage.jsx
+│   │   │   └── AnalyticsPage.jsx
+│   │   ├── store/
+│   │   │   ├── chatStore.js
+│   │   │   ├── adminStore.js
+│   │   │   └── analyticsStore.js
+│   │   ├── utils/
+│   │   │   ├── websocket.js
+│   │   │   ├── api.js
+│   │   │   └── formatters.js
+│   │   ├── App.jsx
+│   │   └── main.jsx
+│   ├── public/
+│   └── package.json
+│
+├── supabase/
+│   ├── migrations/
+│   │   ├── 001_init.sql
+│   │   ├── 002_embeddings.sql
+│   │   ├── 003_redflag_rules.sql
+│   │   └── 004_analytics_tables.sql
+│   ├── seed/
+│   │   ├── default_redflags.sql
+│   │   └── demo_tenants.sql
+│   ├── policies/
+│   │   ├── rls_tenant_documents.sql
+│   │   ├── rls_tenant_embeddings.sql
+│   │   └── rls_admin_rules.sql
+│   ├── functions/
+│   │   └── vector_search.sql
+│   └── README.md
+│
+├── docs/
+│   ├── architecture-diagram.png
+│   ├── sequence-mcp-agent.png
+│   ├── api-spec.md
+│   ├── mcp-server-protocol.md
+│   └── rag-pipeline.md
+│
+├── scripts/
+│   ├── run_dev.sh
+│   ├── build_all.sh
+│   ├── reset_db.sh
+│   └── run_workers.sh
+│
+├── docker-compose.yml
+├── README.md
+└── LICENSE
+```
+
+---
+
+# **🚀 Getting Started**
+
+## **Prerequisites**
+
+* Python 3.10+
+* Node.js 18+
+* Supabase project
+* Groq API key
+* DuckDuckGo Search key (if configured)
+* Slack/Email webhook for alerts (optional)
+
+---
+
+## **Backend Setup**
+
+```sh
+cd backend
+pip install -r requirements.txt
+cp .env.example .env   # Fill in Supabase + Groq keys
+uvicorn app:app --reload
+```
+
+## **Frontend Setup**
+
+```sh
+cd frontend
+npm install
+npm run dev
+```
+
+---
+
+# **✨ Why IntegraChat Stands Out**
+
+* **True MCP-native autonomous agents** (not static prompts)
+* **Enterprise governance system** with regex-based red-flag rules
+* **Hybrid RAG + web search** reasoning
+* **Production-grade multi-tenant design** with strict Supabase RLS
+* **Full observability**: logs, analytics, tool events, violations
+* **Demo-ready**: perfect for enterprise presentations
+
+---
+
+# **🏷 Submission Metadata**
+
+**Track:** MCP in Action
+
+**Category:** Enterprise
+
+**Tag:** `mcp-in-action-track-enterprise`
+
+**Project Name:** **IntegraChat**
+
+### **Short Summary**
+
+> IntegraChat is a multi-tenant AI platform where autonomous MCP-powered agents retrieve private knowledge using RAG, access live web information, and enforce admin-defined safety rules via a red-flag compliance system. It includes an analytics dashboard, tool-selection engine, and strict tenant isolation.
+
+---
+
+# **📄 License**
+
+Add your license here (MIT recommended).
+
+---
+
+# **📬 Contact**
+
+If you'd like, I can generate:
+
+* ✔ Pitch deck
+* ✔ Notion documentation
+* ✔ Demo video script
+* ✔ Architecture diagram SVG
+* ✔ Full API reference
+
+---
+