Opensolr MCP server
com.opensolr/opensolr-mcp·v0.8.1Managed Apache Solr for agents: hybrid BM25+kNN search, server-side embeddings, RAG answers
0 stars498 downloads/wk
Reviews
Write oneNobody has reviewed Opensolr yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Opensolr tools (16, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
opensolr_add_documentsIndex plain-text documents via the Opensolr Data Ingestion API.
opensolr_ai_answerAsk a question and get a grounded RAG answer generated ONLY from the content already indexed in the given Opensolr index. Retrieval runs through the platform's tuned hybrid pipeline (the index's saved Search Tuning applies automatically) — the top rag_docs hits (first rag_words words of text each) become the LLM context, the same pipeline as the hosted search UI. filter_query optionally narrows re
opensolr_apply_schemaInstall the Opensolr vector schema on an index of a vector region, so Data Ingestion, vector and hybrid search and PDF pages all work on it.
opensolr_check_schemaWhether an index is ready for every Opensolr tool, and exactly why not.
opensolr_create_indexwrite actionCreate a new vector-enabled Opensolr index in a vector region. location: an environment id from opensolr_vector_regions, or a short name matched against that live list by environment id or country (e.g. "us", "de"). Additional dedicated regions can be deployed on request (support@opensolr.com).
opensolr_delete_documentswrite actionDelete documents by ids (Solr ids or your original ids) or by a raw Solr query, e.g. 'meta_category:"drafts"' or '+id:"abc123"'.
opensolr_describe_imageWhat a picture shows and what is written on it: "caption" (a sentence about what it depicts), "text" (the text read off it by OCR, empty if none), "labels" (the things in it) and "codes" (barcodes / QR codes). index is the Opensolr index the reading is counted on. Nothing is stored.
opensolr_extract_textRead local files on Opensolr without indexing them: their text, the text in their pictures (OCR, 100+ languages), a PDF page by page, scanned pages and picture files (JPG, PNG, TIFF...) included.
opensolr_index_filesIndex local files into an Opensolr index: one file or a whole folder.
opensolr_index_infoGet connection details for an index: Solr URL, version, environment. (Credentials are intentionally not returned.)
opensolr_ingest_statusStatus of a Data Ingestion job (state, processed/success/failed doc counts). Also visible in the Opensolr Control Panel.
opensolr_list_indexesList all search indexes in the connected Opensolr account.
opensolr_read_documentRead one indexed document in full — search results carry only an excerpt.
opensolr_searchSearch an Opensolr index and return the k most relevant documents.
opensolr_search_by_imageSearch an Opensolr index with a PHOTO instead of a text query.
opensolr_vector_regionsList the vector-enabled Opensolr environments currently available (the servers with the Opensolr web crawler that are up, any Solr version: dense vectors, the hybrid query parser and Data Ingestion).
Public scan report
scanner v0.1.10 · 2026-10-15 · same rubric, same numbers if you re-run it
- Code scan4 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 6 days ago15/15
- Maintainer identitynamespace and repository owner differ; GitHub account older than a year; website matches verified namespace7/10
How Opensolr compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 82/100
- higher than 65% of 4,461 AI and agents servers
- Tools
- 16
- the typical AI and agents server has 6
- Tools that change things
- 13%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 498
- more than 87% of 1,554 AI and agents servers with a package
What its tools let an agent do: 16 create
Release history: 2 versions in the registry since 2026-09-07, latest 2026-10-09, typically one every 33 days.
Install Opensolr in Claude Code, Cursor or VS Code
claude mcp add opensolr-mcp -- uvx opensolr-mcp
What the publisher says
From the Opensolr repository's README, as published. We do not edit it. Read it on GitHub
opensolr-mcp
mcp-name: com.opensolr/opensolr-mcp
MCP (Model Context Protocol) server for Opensolr — gives any AI agent managed Apache Solr search as tools: hybrid (BM25 + kNN) retrieval, server-side GPU embeddings, document indexing, and grounded RAG answers.
See it live (real news index, hybrid + AI answer): https://search.opensolr.com/news__dense?q=how+am+I+supposed+to+save+money%3F
No embedding model to configure. No vector database to run. One API key.
Tools
Setup
Get a free Opensolr account (free forever, no card) at opensolr.com/register and copy your API key from Account.
Try it without an account
There is a public demo account. Point the package at it and everything in this README works immediately, with no signup:
export OPENSOLR_EMAIL=mcp@opensolr.com
export OPENSOLR_API_KEY=420b8b23e7b12dc8ab838932145a5065mcpdemod1__dense is already loaded with 300 news articles, so search, filtering and grounded answers work the moment you connect. You also get the full write path: create your own index on the account, ingest into it, query it, delete it.
Know what you are working with:
or export. That includes indexes you created and every document in them.
- Anything you create there is deleted after 3 days. Automatically, without warning
they can change or delete it, and you can do the same to theirs. Never put anything real, private or client-owned in it.
- The account is shared with everyone reading this. Your index is visible to them,
of disk per index. Bandwidth is the one you will hit first: it covers a demo, a tutorial and a proof of concept, and it will not carry an application.
- The limits are per index, and deliberately small. 200 MB of bandwidth and 50 MB
When you want an index that is private, yours and still there next week, get your own key — free forever, no card — and change the two variables above. Nothing else in your code changes.
Claude Desktop / Claude Code
{
"mcpServers": {
"opensolr": {
"command": "uvx",
"args": ["opensolr-mcp"],
"env": {
"OPENSOLR_EMAIL": "you@example.com",
"OPENSOLR_API_KEY": "YOUR_OPENSOLR_API_KEY"
}
}
}
}Cursor / Windsurf / any MCP client
Same shape — stdio transport, command uvx opensolr-mcp (or pipx run opensolr-mcp), with OPENSOLREMAIL and OPENSOLRAPI_KEY in env.
Example agent session
You: Index our FAQ answers, then find everything about refunds.
The agent calls opensolradddocuments(index="faq__dense", texts=[...]),
then opensolrsearch(index="faqdense", query="refund policy", hybrid=True)
— BM25 catches the exact word "refund", kNN catches "giving customers their
money back", and the scores fuse per document.
Search with a photo
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Opensolr: common questions
- Is Opensolr MCP server safe?
- Mostly: it is graded B (82/100). Read the Opensolr safety report
- How do I install Opensolr?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Opensolr need an API key?
- Yes. The registry entry asks for
OPENSOLR_API_KEY. - Is Opensolr maintained?
- The last commit was 27 days ago (2026-10-09). The latest release is v0.8.1.
- What can I use instead of Opensolr?
- Servers from other publishers that do the same job: PDF MCP server, Local Rag MCP server and Butterbase AI MCP server.
- How does Opensolr compare with other AI and agents MCP servers?
- safety score 82/100 (higher than 65% of 4,461 AI and agents servers); tools 16 (the typical AI and agents server has 6); tools that change things 13% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Opensolr
Same job from other publishers: the closest match first, then the best rated.
- PDFAgentic RAG over one PDF or a whole folder: hybrid search, selective page reads, tables, OCR.not reviewedEstablishedA
- Local RagEasy-to-setup local RAG server with minimal configurationnot reviewedEstablishedA
- Butterbase AIButterbase MCP server — manage your backend: schemas, auth, functions, storage, RAG, deploys.not reviewedEstablishedA
- Alibaba Cloud DashScope — QwenAlibaba Cloud DashScope MCP: Qwen chat, embeddings, and model discovery on your own account.not reviewedEstablishedB
GuaardvarkLocal AI studio on your GPU: images, video, music, voice, RAG. Needs the Guaardvark app installed.not reviewedEstablishedB