What does the minima mcp server do?

It connects Minima to MCP-compatible AI assistants such as Claude and Cursor. Instead of copying data back and forth by hand, the assistant works with Minima directly.

How do I install the minima mcp server?

Register the server in your MCP client's configuration file and restart the client. This page carries ready-made configuration blocks for Claude Desktop, Claude Code and Cursor.

What credentials does it need?

It reads `LOCAL_FILES_PATH`, `EMBEDDING_MODEL_ID`, `LLM_BASE_URL`, `LLM_API_KEY`, `USER_ID` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

Minima MCP Server — Setup Guide for Claude

What is the Minima MCP server?

Minima mcp server lets Claude, Cursor and other MCP clients work with Minima directly. Minima currently supports four modes: 1. Isolated installation (Ollama) – Operate fully on-premises with containers, free from external dependencies such as ChatGPT or Claude. All neural networks (LLM, reranker, embedding) run on your cloud or PC, ensuring your data remains secure.

What Minima does

Minima currently supports four modes: 1. Isolated installation (Ollama) – Operate fully on-premises with containers, free from external dependencies such as ChatGPT or Claude. All neural networks (LLM, reranker, embedding) run on your cloud or PC, ensuring your data remains secure.

Installing the minima mcp server

Setup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.

Configuration

Before the server will start you need to supply 5 environment variables: LOCAL_FILES_PATH, EMBEDDING_MODEL_ID, LLM_BASE_URL, LLM_API_KEY, USER_ID. Keep credentials in your client's env block or a secrets manager rather than committing them.

Where it fits

AI-service servers chain other models into your assistant, turning a single chat into a small production pipeline. Minima sits in that group. Worth comparing against the other ai services servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
It will not start until its required credentials are present, so set those before wondering why the tools never appear.
Maintained by dmayboroda, written in Python.
MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the minima mcp server actually does with your data.
Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

How to install the Minima MCP server

{
    "mcpServers": {
      "minima": {
        "command": "uv",
        "args": [
          "--directory",
          "/path_to_cloned_minima_project/mcp-server",
          "run",
          "minima"
        ]
      }
    }
  }

Configuration as documented by the project. Restart the client after saving.

Configuration

Variable	Description	Required
LOCAL_FILES_PATH	Filesystem location the server is allowed to use.	Optional
EMBEDDING_MODEL_ID	Configuration value read at startup.	Optional
LLM_BASE_URL	Endpoint or connection string the server talks to.	Yes
LLM_API_KEY	Credential the server authenticates with.	Yes
USER_ID	Configuration value read at startup.	Optional

Minima MCP Server

What is the Minima MCP server?

What Minima does

Installing the minima mcp server

Configuration

Where it fits

Practical notes

How to install the Minima MCP server

Configuration

Frequently asked questions

Alternatives to the Minima MCP server

Fonoster

Exa

Perplexity

ElevenLabs

E2B

Hugging Face