Land Rover Discovery II Maintenance Assistant (MCP Server)

This is a transformation of https://github.com/TommiA/LRDISCO2_RAG_LLAMA3 to MCP server.

This is an intersectional combination of Artificial Intelligence (AI) and specifically Large Language Models (LLM), Natural Language Processing, PDFs, Land Rovers and car maintenance - a rainy day summer project for fun.

This project implements a Retrieval-Augmented Generation (RAG) system with a quantized version of the LLAMA 3 8B Large Language Model. The system uses the Chroma vector database to store parts of the Land Rover Discovery II maintenance manual (not included in this repository) and provides a knowledge base about the Discovery II and its maintenance. Data is not included: See read_pdf_to_chroma_langchain.py to preprocesses the input PDF file to the data/pdf folder, dividing it to chunks of text and embedding, finally storing it to the Chroma DB. You need to have your own legal copy of RAVE to source the PDF.

The core of this system is a Model Control Protocol (MCP) server that exposes a single tool for querying the knowledge base. This server architecture allows for flexible integration with various clients and applications.

MCP Server Architecture

The system is built around a FastMCP server that provides a single tool for querying the knowledge base:

• MCP Server: LRDISCO2_MCP_server.py - A FastMCP server that exposes a single tool for querying the ChromaDB knowledge base

• Knowledge Base: ChromaDB with embeddings from the Land Rover Discovery II maintenance manual

• Embedding Model: GPT4All's Embed4All model for creating document embeddings

• Query Tool: search_knowledge_base - A single tool that searches the ChromaDB knowledge base for documents relevant to the user's query

The MCP server architecture allows for seamless integration with various clients and applications, making it easy to query the Land Rover Discovery II maintenance knowledge base from different environments.

Related MCP server: MCP Generix

Core Components

1. Knowledge Base

The ChromaDB database stores chunks of text from the Land Rover Discovery II maintenance manual, each with an embedding vector created using the GPT4All Embed4All model. The database is stored at data/db/ and uses the collection name LR_Disco_2_embed4all.

2. MCP Server

The LRDISCO2_MCP_server.py file implements the FastMCP server that exposes a single tool for querying the knowledge base. The server uses the following components:

• ChromaDB client connected to the persistent database

• Embed4All model for creating query embeddings

• FastMCP framework for handling MCP protocol

3. Query Tool

The search_knowledge_base function is the only tool exposed by the MCP server. It takes a user query and returns relevant documents from the ChromaDB knowledge base. The function:

• Creates an embedding for the user's query

• Searches ChromaDB using the query embedding

• Returns the top results with their distances and documents

Usage

Starting the MCP Server

To start the MCP server, run:

python LRDISCO2_MCP_server.py

The server will start listening for MCP requests and expose the search_knowledge_base tool.

Using the MCP Server on LM Studio

See 'mcp.json' for adding this MCP server to your LM Studio instance, edit the path accordingly.

Testing using Langchain client, local MCP Server and LM Studio

Run 'langchain_test_client.py', set LM Studio ip-addresses as needed in script or setting LM_STUDIO_BASEURL using .env, use OpenAI URL style.

'langchain_test_client.py' switches

The script supports the following command-line options:

• -p, --prompt : custom user prompt text

• -i, --interactive : start an interactive chat loop