mcp-business-bot
Enables querying company knowledge base using RAG, providing accurate answers from internal documents via MCP.
README
Business Knowledge AI Bot with RAG & MCP
An AI-powered enterprise knowledge assistant that answers company-specific questions using Retrieval-Augmented Generation (RAG), ChromaDB, LangChain, OpenAI, and the Model Context Protocol (MCP).
The assistant retrieves relevant information from internal company documents before generating accurate, context-aware responses.
Project Overview
This project demonstrates how a business can use AI to provide employees with instant access to company knowledge without requiring manual document searches.
Instead of relying solely on an LLM's general knowledge, the assistant searches a private knowledge base built from company documentation and uses the retrieved information to generate reliable answers.
The project is designed as a portfolio example of an enterprise AI assistant.
Features
- PDF document ingestion
- Semantic search using vector embeddings
- Retrieval-Augmented Generation (RAG)
- Natural language question answering
- ChromaDB vector database
- OpenAI GPT integration
- Model Context Protocol (MCP) server
- Gradio web interface
- Fast semantic document retrieval
System Architecture
Company Documents
│
▼
PDF Document Loader
│
▼
Text Chunking
│
▼
Sentence Transformers Embeddings
│
▼
Chroma Vector Database
│
▼
Semantic Similarity Search
│
▼
Retrieved Context
│
▼
OpenAI GPT-4.1-mini
│
▼
MCP Server
│
▼
Gradio Web UI
Technology Stack
| Technology | Purpose |
|---|---|
| Python 3.14 | Programming Language |
| LangChain | RAG Framework |
| OpenAI | Large Language Model |
| ChromaDB | Vector Database |
| Sentence Transformers | Text Embeddings |
| HuggingFace | Embedding Models |
| MCP SDK | Model Context Protocol |
| Gradio | Web Interface |
| PyPDF | PDF Processing |
Project Structure
mcp-business-bot/
│
├── app.py
├── config.py
├── ingest.py
├── rag.py
├── mcp_server.py
├── prompts.py
├── requirements.txt
├── README.md
│
├── assets/
│ └── screenshot.png
│
├── knowledge/
│ ├── company_handbook.pdf
│ ├── TechSolutions_Company_Policies.pdf
│ ├── TechSolutions_Internal_Procedures.pdf
│ ├── TechSolutions_Product_Information.pdf
│ ├── TechSolutions_Technical_Documentation.pdf
│ └── mcp_architecture.md
│
└── chroma_db/
Knowledge Base
The assistant indexes multiple business documents, including:
- Company Handbook
- Company Policies
- Internal Procedures
- Product Information
- Technical Documentation
- MCP Architecture
These documents are converted into semantic embeddings and stored in ChromaDB for efficient retrieval.
Installation
Clone the repository:
git clone https://github.com/Akes102/mcp-business-bot.git
cd mcp-business-bot
Create a virtual environment:
python -m venv .venv
Activate the environment.
Windows:
.venv\Scripts\activate
Install dependencies:
pip install -r requirements.txt
Create a .env file:
OPENAI_API_KEY=your_api_key_here
Build the Knowledge Base
After adding PDF documents to the knowledge folder:
python ingest.py
The ingestion process:
- Loads PDFs
- Splits text into chunks
- Generates embeddings
- Stores vectors in ChromaDB
Run the Application
Start the Gradio interface:
python app.py
Open your browser:
http://127.0.0.1:7860
Example Questions
Try asking:
- What cybersecurity policies does TechSolutions have?
- Explain the employee onboarding process.
- What products does TechSolutions provide?
- What is the company's password policy?
- How are IT incidents escalated?
- Explain the MCP architecture used in this project.
How RAG Works
- User submits a question.
- The question is converted into an embedding.
- ChromaDB searches for similar document chunks.
- Relevant context is retrieved.
- The retrieved context is sent to the OpenAI model.
- The AI generates an accurate response based on company documentation.
This process helps reduce hallucinations by grounding responses in the indexed documents.
Model Context Protocol (MCP)
This project includes an MCP server that exposes the RAG functionality through the Model Context Protocol.
Using MCP allows compatible AI clients to access the enterprise knowledge base in a standardized way.
Demo
Application
Replace with your own screenshot:
assets/screenshot.png
Future Improvements
- User authentication
- Multi-user support
- Role-based access control
- Conversation history
- Source citations
- Streaming responses
- Docker deployment
- Cloud deployment
- Multi-document collections
- Admin dashboard
Learning Outcomes
This project demonstrates practical experience with:
- Retrieval-Augmented Generation (RAG)
- Enterprise AI Assistants
- LangChain
- ChromaDB
- OpenAI API
- Vector Embeddings
- MCP
- Gradio
- Semantic Search
- Prompt Engineering
📄 License
This project is intended for educational and portfolio purposes.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.