Skip to content
MCP server

Opensolr MCP

Hybrid keyword and semantic search, indexing and RAG answers over Opensolr Solr indexes

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
0.8.1
Listing updated
2 days ago

About Opensolr MCP

Opensolr MCP is a freemium MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Opensolr's MCP server turns a managed Apache Solr index into tools an agent can call with plain text. Embeddings are computed server-side, so there is no embedding model to configure and no vector database to run. Search blends BM25 keyword and kNN semantic retrieval, supports Solr filters and date ranges, and a matching PDF comes back as its best page with a link that opens at that page.

It goes beyond text queries. An agent can search with a photo, since Opensolr reads the picture's labels, OCR text and any barcode or QR code and searches on those words. Local files and folders can be indexed, with PDFs split one document per page and scans and pictures read through OCR, or read without indexing at all. The opensolr_ai_answer tool builds a grounded answer from the top hybrid hits.

The package is opensolr-mcp on PyPI, started with uvx over stdio and needing an account email and API key. A shared public demo account exists with a preloaded news index, but anything created there is deleted after 3 days and visible to others, so keep real data out of it.

Install

Run in a terminal

claude mcp add opensolr-mcp --env OPENSOLR_EMAIL='<OPENSOLR_EMAIL>' --env OPENSOLR_API_KEY='<OPENSOLR_API_KEY>' -- uvx opensolr-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "opensolr-mcp": {
      "command": "uvx",
      "args": [
        "opensolr-mcp"
      ],
      "env": {
        "OPENSOLR_EMAIL": "<OPENSOLR_EMAIL>",
        "OPENSOLR_API_KEY": "<OPENSOLR_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "opensolr-mcp": {
      "command": "uvx",
      "args": [
        "opensolr-mcp"
      ],
      "env": {
        "OPENSOLR_EMAIL": "<OPENSOLR_EMAIL>",
        "OPENSOLR_API_KEY": "<OPENSOLR_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "opensolr-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "opensolr-mcp"
      ],
      "env": {
        "OPENSOLR_EMAIL": "<OPENSOLR_EMAIL>",
        "OPENSOLR_API_KEY": "<OPENSOLR_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "opensolr-mcp": {
      "command": "uvx",
      "args": [
        "opensolr-mcp"
      ],
      "env": {
        "OPENSOLR_EMAIL": "<OPENSOLR_EMAIL>",
        "OPENSOLR_API_KEY": "<OPENSOLR_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "opensolr-mcp": {
      "command": "uvx",
      "args": [
        "opensolr-mcp"
      ],
      "env": {
        "OPENSOLR_EMAIL": "<OPENSOLR_EMAIL>",
        "OPENSOLR_API_KEY": "<OPENSOLR_API_KEY>"
      }
    }
  }
}

Configuration

  • OPENSOLR_EMAILOpensolr account email; try the shared demo account mcp@opensolr.com, whose indexes are deleted after 3 days and can be changed or deleted by anyone else using it, or get your own at https://opensolr.com/register (free forever, no card)Required
  • OPENSOLR_API_KEYOpensolr API key, found under Account > API in the control panel; the shared demo account's key is 420b8b23e7b12dc8ab838932145a5065 (preloaded index mcp_demo_d1__dense with 300 news articles, limits per index are 200 MB bandwidth and 50 MB disk, anything created is deleted after 3 days and other people can change or delete it)Required

Tools this server provides (15)

Taken from the project documentation; the running server may differ.

opensolr_search
Hybrid or semantic search with filters and date range
opensolr_search_by_image
Search with a photo using its labels, OCR and barcodes
opensolr_read_document
Read a result in full
opensolr_ai_answer
Grounded RAG answer from the top hybrid hits
opensolr_index_files
Index a local file or folder
opensolr_extract_text
Read local files without indexing them
opensolr_describe_image
Describe a picture, its text and labels
opensolr_add_documents
Index plain text with metadata
opensolr_delete_documents
Remove documents by id
opensolr_list_indexes
List the account's indexes
opensolr_index_info
Inspect an index
opensolr_create_index
Provision a vector index in a region
opensolr_vector_regions
List vector-enabled regions
opensolr_check_schema
Check whether an index supports each tool
opensolr_apply_schema
Install the Opensolr vector schema on an index

What it does

Hybrid search
BM25 plus kNN retrieval with filters and date ranges.
Search by image
Uses a photo's labels, OCR text and barcodes as the query.
Grounded RAG answers
Top hybrid hits feed an LLM answer.
File indexing and OCR
Index PDFs page by page, Office-style documents and scans.
Index management
Create indexes in a vector region, check and apply the schema.
Server-side embeddings
No embedding model or vector store to run yourself.

Good for

  • Give an agent search over your own documents
  • Answer questions from a folder of PDFs with citations to pages
  • Find products or documents from a photo
  • Prototype RAG without hosting a vector database
  • Index and query scanned files through OCR

Pricing

Freemium

Free-forever plan with no card; paid hosting plans, prices not listed

Prices change. Check opensolr.com before you buy.

Opensolr MCP FAQ

How do I run it?

With uvx opensolr-mcp over stdio, setting OPENSOLR_EMAIL and OPENSOLR_API_KEY.

Is there a free way to try it?

Yes, a free-forever Opensolr plan without a card, or a shared demo account whose data is deleted after 3 days.

Is the demo account private?

No. It is shared with everyone and has 200 MB bandwidth and 50 MB disk limits per index.

Which clients work?

Claude Desktop, Claude Code, Cursor, Windsurf and other MCP clients.

Is Opensolr MCP free?

Opensolr MCP has a free plan, with paid plans for more usage or features.

How do I add Opensolr MCP to Claude Code?

Run this command in your terminal: claude mcp add opensolr-mcp --env OPENSOLR_EMAIL='<OPENSOLR_EMAIL>' --env OPENSOLR_API_KEY='<OPENSOLR_API_KEY>' -- uvx opensolr-mcp

What are the best alternatives to Opensolr MCP?

The closest alternatives to Opensolr MCP are Scrapling MCP Server, Codebase Memory, XERJ, Firecrawl MCP Server and Claude Code Ultimate Guide.

Alternatives to Opensolr MCP

  1. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  4. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  5. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  6. SearXNG Search

    MCP server

    MCP server for web search and page reading through a SearXNG instance

    Runs locally
    • 3 tools
    • Open source
    • 1.4K GitHub stars
    • Web search and scraping