Minima MCP
On-premises RAG in containers with an MCP server: the agent searches your documents while data stays local
- 1,056 ★ on the repository
- Last commit
- MPL-2.0
Extended access
Why this level
- Indexes local documents in containers
- In some modes sends queries to external models
Install
- Works in
Manual install
docker compose -f docker-compose-mcp.yml --env-file .env up --buildFill in .env from .env.sample before launching. Other modes have their own compose files.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Indexes local documents in containers
- In some modes sends queries to external models
This is third-party code. Review the repository files before installing.
What it does
Minima is an open-source RAG that runs in containers and indexes local documents. It works in several modes: fully local with Ollama, with your own model over an OpenAI-compatible API, integrated into ChatGPT via a custom GPT, and with the Anthropic Claude app. In MCP mode the Claude Desktop app connects to the Minima server and searches your files while the indexer stays on your machine. It launches through docker compose with a separate file per mode and environment variables in .env.
Who it is for. For teams and specialists who need search over their own documents with data kept on their own infrastructure.
Good fit when
- You need to search local documents through Claude or ChatGPT
- You need a RAG where data does not leave your side
- You want to connect a local knowledge base to an agent via MCP
Not a fit when
- You cannot run Docker containers
- You want a ready cloud search without your own infrastructure
Example request
Search my local documents for the sections on the leave policy and cite the sourcesMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
LOCAL_FILES_PATHrequired- Path to the folder of documents to index
EMBEDDING_MODEL_IDrequired- Embedding model for indexing
LLM_API_KEYsecret- API key for your custom model if it requires authorization
Limitations
It needs Docker and .env setup, and the local mode needs Ollama and reranker models. The ChatGPT and Claude modes assume access to external services, some of which do not work from Russia without VPN. Deployment and maintenance are on the user.
How to disable. Stop the containers with docker compose down and remove the minima server from the MCP config.
FAQ
Does data leave my side?
In the local Ollama mode everything runs on your machine. In the ChatGPT and Claude modes the primary model is external while the indexer stays local.
Which modes are there?
Fully local on Ollama, your own model over an OpenAI-compatible API, ChatGPT integration, and the Claude app via MCP.
Discussion
No questions or reviews yet.
Related
MCP serversMCP Local RAG
mcp-local-rag
Local search over your documents, semantic and keyword, with no keys, Docker or external database. Works offline after the first model download
minirag-mcp searches your documents with hybrid vector and BM25 search and runs on your computer without sending files out
A local MCP server that turns a folder of documents into a knowledge base with hybrid search for Claude Code and Cursor
A self-hosted RAG app with a web interface and a built-in MCP server: documents, Qdrant and answers with sources.
MCP server for the Flexible GraphRAG platform: ingest from 14 data sources, hybrid search and AI answers over a knowledge graph
The official Graphlit MCP server: an agent collects material from Slack, GitHub, mail and websites into a knowledge base and searches it
README in short
The README describes an open-source containerized RAG that indexes local documents and runs in four modes: local on Ollama, your own model over an OpenAI-compatible API, ChatGPT via a custom GPT, and the Claude app. It launches through docker compose with a file per mode and .env variables, and for MCP it shows a config snippet that runs via uv. There is a web UI and an Electron desktop app. MPL-2.0 licensed.