Opensolr MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/opensolr-com-opensolr-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

11 read · 3 write · 1 delete · 1 not yet classified

Secrets

1 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Python package

Tools (16)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• opensolr_add_documents

  Index plain-text documents via the Opensolr Data Ingestion API. Ingestion is ASYNC: embeddings, sentiment, and all derived fields are computed server-side and documents become searchable within about a minute (progress is visible in the Opensolr Control Panel). With wait=true (default) this blocks until the job completes. Metadata keys become filterable meta_* fields; metadata "uri" (a real URL) is used as the document identity — the Solr id is md5(uri). Returns job info and the resulting Solr document ids.

• opensolr_ai_answer

  Ask 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 retrieval with a raw Solr fq expression; instruction optionally replaces the default prompt (e.g. "Answer in German", "Extract a list of people"); tuning optionally overrides retrieval knobs per call. T…

• opensolr_apply_schema

  Install 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. It replaces the index configuration. An index that already holds documents needs force=true: those documents keep the fields they were written with and must be sent again. An index outside the vector regions cannot take it (the answer says where to create one). Returns the new check.

• opensolr_check_schema

  Whether an index is ready for every Opensolr tool, and exactly why not. Answers "ready", "capabilities" (ingestion, vector_search, pdf_pages, keyword_search), the server and its Solr version, whether the server is in a vector region, the fields and types that are missing or different from the Opensolr vector schema, "problems" (sentences) and "fix": "apply_schema" (run opensolr_apply_schema), "new_index" (create one with opensolr_create_index in a region of opensolr_vector_regions) or "none". The other tools run this check once per index on their own; call it to see the details.

• opensolr_create_index

  Create 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_documents

  Delete 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_image

  What 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_text

  Read 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. path is a file or a folder (pattern filters the files of a folder, e.g. "*.pdf"; recursive walks its sub-folders). index is the Opensolr index the work is counted on (pictures read: 0.5 AI request each; a file read before is free). Files still being read after wait_seconds come back with state "queued"/"processing": call again with the same path to get them — they are not sent twice. Each file: path,…

• opensolr_index_files

  Index local files into an Opensolr index: one file or a whole folder. Each file is read on Opensolr — its text, the text in its pictures (OCR), the pictures without text described — and a PDF is indexed ONE DOCUMENT PER PAGE, so a search finds the page that answers it (results carry the page number and a link to it). Word, RTF, OpenDocument, text, HTML and picture files (scans) are one document each. pattern filters the files of a folder (e.g. "*.pdf"), recursive walks its sub-folders, metadata is added to every document as filterable meta_* fields. Sending the same files again replaces them.…

• opensolr_index_info

  Get connection details for an index: Solr URL, version, environment. (Credentials are intentionally not returned.)

• opensolr_ingest_status

  Status of a Data Ingestion job (state, processed/success/failed doc counts). Also visible in the Opensolr Control Panel.

• opensolr_list_indexes

  List all search indexes in the connected Opensolr account.

• opensolr_read_document

  Read one indexed document in full — search results carry only an excerpt. document is the "document_id" or "id" of a search result, the id it was sent with, or its URL. A PDF indexed page by page comes back as its pages in order (page_from to page_to, default the first 50; "pages_indexed" tells how many it has) — read the next ones with page_from. Any other document comes back as one text. The answer is cut at max_chars characters ("truncated": true).

• opensolr_search

  Search an Opensolr index and return the k most relevant documents. search_mode: "hybrid" (default — BM25 + semantic kNN fused per document), "semantic" (pure kNN), or "lexical" (pure keyword edismax — no embedding call, zero AI quota, works on ANY index including non-vector ones). For hybrid: mode is union / keywords_required / meaning_required / intersection, alpha balances semantic (0) vs lexical (1). filter_query accepts a raw Solr fq expression, e.g. 'meta_category:"docs"'. fresh_bias biases the ranking toward recent documents by multiplying each score by a recency curve on creation_date.…

• opensolr_search_by_image

  Search an Opensolr index with a PHOTO instead of a text query. The image at image_path is read three ways by the Opensolr image engine — visual labels (what it depicts), OCR text (words printed on it), and any barcode / QR code — and turned into a text query that runs through the normal search. No image vector is stored; the picture simply becomes words. using selects which reading drives the search: "auto" the engine's chosen text (OCR text when the picture is mostly text, otherwise the visual labels) — the default, "meaning" the visual labels (what the picture depicts), …

Signals

Stars

0

Forks

0

Open issues

0

Weekly downloads

81

Last commit

Oct 9, 2026 (19 days ago)

Last release

Oct 9, 2026 (19 days ago)

Last package publish

Oct 9, 2026 (19 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

com.opensolr/opensolr-mcp

Version

0.8.1

Auth

API key

Packages

pypi opensolr-mcp

License

MIT

Repository

github.com/phpcip/opensolr-mcp

Website

opensolr.com/mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql