Skip to main content

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.

No embedding model to configure. No vector database to run. One API key.

Tools

Tool What it does
opensolr_search Hybrid (keyword + semantic) or pure semantic search, with Solr filters
opensolr_ai_answer Grounded RAG answer generated only from your indexed content
opensolr_add_documents Index plain text + metadata (embedded server-side)
opensolr_delete_documents Remove documents by id
opensolr_list_indexes / opensolr_index_info Inspect the account's indexes
opensolr_create_index Provision a vector-enabled index (us, de, fi)
opensolr_vector_regions Live list of vector-enabled regions

Setup

Get a free Opensolr account (15-day trial, no card) at opensolr.com/register and copy your API key from Account.

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 OPENSOLR_EMAIL and OPENSOLR_API_KEY in env.

Example agent session

You: Index our FAQ answers, then find everything about refunds.

The agent calls opensolr_add_documents(index="faq__dense", texts=[...]), then opensolr_search(index="faq__dense", query="refund policy", hybrid=True) — BM25 catches the exact word "refund", kNN catches "giving customers their money back", and the scores fuse per document.

Notes

  • Vector-enabled indexes run on Opensolr's Solr 9.x environments — currently us (Chicago), de (Germany), fi (Finland), fetched live via opensolr_vector_regions. Additional dedicated regions can be deployed on request (paid add-on): support@opensolr.com.
  • Every index is also plain Apache Solr with the native /select API — nothing is locked behind the tools.
  • Python sibling for LangChain: langchain-opensolr · Product page: opensolr.com/langchain

MIT license.

Metadata

Release files for opensolr-mcp 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for opensolr-mcp 0.1.2
File Size Uploaded Provenance Actions
opensolr_mcp-0.1.2.tar.gz 9.3 kB Without provenance Details for opensolr_mcp-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for opensolr-mcp 0.1.2
File Interpreter ABI Platform Actions
opensolr_mcp-0.1.2-py3-none-any.whl Python 3 none any Details for opensolr_mcp-0.1.2-py3-none-any.whl

Total release size: 19.6 kB

Release files / opensolr_mcp-0.1.2.tar.gz

Download URL opensolr_mcp-0.1.2.tar.gz
Size 9.3 kB
Tags Source
SHA-256 checksum
How to use checksums
678488547156d73a9449fd838dd8cfd2a905bf21fe748a52b12807ef1201dbdd
BLAKE2b-256 checksum
How to use checksums
6c32fe168d0f6989030ab62ebec12294600b97a12d32ed498eefb4deafb5fa33
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.12

Release files / opensolr_mcp-0.1.2-py3-none-any.whl

Download URL opensolr_mcp-0.1.2-py3-none-any.whl
Size 10.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9e15d1bf942e802cbffbbb25bac323e15956fa1eac50209afd2f17f956e4f21f
BLAKE2b-256 checksum
How to use checksums
33afc8376cb799ba8251077f2d06d501093682529937c1ae82bb8d60d4fc410f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.12

Security for opensolr-mcp 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page