Skip to main content

MCP Server RAG

RAG (Retrieval-Augmented Generation) server for MCP (Model Control Protocol). This server provides vector-based document retrieval functionality to enhance LLM interactions with contextual information.

Overview

The MCP Server RAG implementation provides a bridge between your LLM applications and document collections, offering:

  • Vector-based document search using ChromaDB and Sentence Transformers
  • Multiple specialized collections (liv, ken, ufa, sap commerce)
  • Strongly typed API responses
  • Integration with the MCP server infrastructure

Installation

pip install rag-mcp-server

Usage

After installation, you can run the server with:

mcp-server-rag

Or using Python module syntax:

python -m mcp_server_rag

Features

  • Vector-based search for contextual document retrieval
  • Persistent storage of document embeddings via ChromaDB
  • Multiple collection support for domain-specific searches
  • Configurable via environment variables
  • Fully typed response objects with detailed metadata
  • Seamless integration with the MCP protocol

Available Collections

The server provides access to four specialized collections:

  • liv-rag: LIV document collection (retrieve_liv_context tool)
  • ken-rag: Kennametal document collection (retrieve_ken_context tool)
  • ufa-rag: UFA document collection (retrieve_ufa_context tool)
  • sap-comm-rag: SAP Commerce document collection (retrieve_sap_comm_context tool)

Configuration

The following environment variables can be used to configure the server:

Variable Description Default
RAG_PERSIST_DIR Directory where ChromaDB will store its data ~/Documents/chroma_db
RAG_EMBEDDING_MODEL Path or name of the Sentence Transformer model ~/LLM/huggingface/hub/models--sentence-transformers--all-MiniLM-L6-v2/...
RAG_N_RESULTS Default number of results to return from searches 5

Dependencies

  • click
  • mcp (version 1.2.0 or higher)
  • chromadb
  • sentence-transformers

Development

Building and Publishing

The repo includes a publish.sh script that helps with building and publishing the package.

./publish.sh

This script will clean previous build artifacts, install build dependencies, build the package, and check it before providing instructions for publishing to PyPI.

License

MIT

Metadata

Release files for mcp-server-rag 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-server-rag 0.2.0
File Size Uploaded
mcp_server_rag-0.2.0.tar.gz 7.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-server-rag 0.2.0
File Interpreter ABI Platform
mcp_server_rag-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 14.3 kB

Release files / mcp_server_rag-0.2.0.tar.gz

Download URL mcp_server_rag-0.2.0.tar.gz
Size 7.4 kB
Tags Source
SHA-256 checksum
How to use checksums
5d72502682deecde696c94e9bc3313b1a32aba90d85a70bb6ba796a23523e875
BLAKE2b-256 checksum
How to use checksums
1dbbc990c80ea7a24a4ec323ddc9505937844ce43a4601bb96931d68d4486488
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.5

Release files / mcp_server_rag-0.2.0-py3-none-any.whl

Download URL mcp_server_rag-0.2.0-py3-none-any.whl
Size 6.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ffc64b7be689c4c03ea703c15770fbb7a6318d9aeddec163b0100119a4287a46
BLAKE2b-256 checksum
How to use checksums
1e9ae587e419d7ef992a9598e874f02859874dc263ab7d3cddf9c2662f4bcaab
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.5

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

0.1.24

2 release files

0.1.4

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page