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.1

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.1
File Size Uploaded Provenance Actions
opensolr_mcp-0.1.1.tar.gz 9.3 kB Without provenance Details for opensolr_mcp-0.1.1.tar.gz

Built distribution (wheel)

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

Total release size: 19.6 kB

Release files / opensolr_mcp-0.1.1.tar.gz

Download URL opensolr_mcp-0.1.1.tar.gz
Size 9.3 kB
Tags Source
SHA-256 checksum
How to use checksums
47fa7200dd94cb894c12ede0c109e8f611f4d7d17edbc534720e9da801fc5101
BLAKE2b-256 checksum
How to use checksums
b49dfb98ae5a195b1bacedab0fcda9dcdb5142329ef6040bbbc26522779bcc58
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.1-py3-none-any.whl

Download URL opensolr_mcp-0.1.1-py3-none-any.whl
Size 10.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
af328867690e546268ac19bafb1ed84a4ab369ed61310182de5787bc424ea689
BLAKE2b-256 checksum
How to use checksums
7b66924d898fb234f6d04b7c855acfe28514cb31a502b69fd0cdae1a6cb979e3
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.1

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