Opensolr MCP
Hybrid keyword and semantic search, indexing and RAG answers over Opensolr Solr indexes
- 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-mcpAdd 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)RequiredOPENSOLR_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

Scrapling MCP Server
MCP serverMCP 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

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Firecrawl MCP Server
MCP serverMCP server that lets AI agents search, scrape and interact with web pages
- 3 tools
- Remote
- Freemium
- 7.8K GitHub stars
- Web search and scraping

Claude Code Ultimate Guide
MCP serverMCP 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

SearXNG Search
MCP serverMCP 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