OpenSEO
Keyword research, site audits, rank tracking and AI visibility for your AI agent.
Se ejecuta en la nube✓ everyapp.com
Opensolr MCP
What it does
Managed Apache Solr for agents: hybrid BM25+kNN search, server-side embeddings, RAG answers
- Connects Se ejecuta en tu computadora
- Account or key Needs OPENSOLR_API_KEY · 1 setting to fill in (OPENSOLR_EMAIL)
- Category Búsqueda y memoria de IA
Instalación
Elige la app de IA que usas y copia la configuración.
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 13 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de Opensolr MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (OPENSOLR_EMAIL) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Que la IA lo instale
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Opensolr MCP para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "opensolr": { "command": "uvx", "args": [ "opensolr-mcp" ], "env": { "OPENSOLR_EMAIL": "your-value", "OPENSOLR_API_KEY": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En OPENSOLR_API_KEY, OPENSOLR_EMAIL deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Opensolr MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
uv --versionSe instala una vez y sirve para todo lo que usa uv
Regístrate y crea una clave de Opensolr MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Rellena 1 ajuste(s)
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
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…
Las descripciones siguen en el inglés original.
Abre el archivo de configuración de la app de Claude de escritorio
SettingsDeveloperEdit Config
Pega esta configuración y guarda el archivo
{ "mcpServers": { "opensolr": { "command": "uvx", "args": [ "opensolr-mcp" ], "env": { "OPENSOLR_EMAIL": "your-value", "OPENSOLR_API_KEY": "your-value" } } } }Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Cierra Claude y vuelve a abrirlo
Pruébalo
Usa Opensolr MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Opensolr MCP o muestra una herramienta de Opensolr MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Opensolr MCP
Opensolr MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
Lo que puedes hacer en su lugar
A · Usa una app que pueda conectar Opensolr MCP
- Necesitas una clave de Opensolr MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (OPENSOLR_EMAIL) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
- Necesitas una clave de Opensolr MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (OPENSOLR_EMAIL) · Instala Python (uv) en tu computadora primero (una sola vez)
- Necesitas una clave de Opensolr MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (OPENSOLR_EMAIL) · Instala Python (uv) en tu computadora primero (una sola vez)
- Necesitas una clave de Opensolr MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (OPENSOLR_EMAIL) · Instala Python (uv) en tu computadora primero (una sola vez)
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Opensolr MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (OPENSOLR_EMAIL) · Instala Python (uv) en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Opensolr MCP para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user opensolr --env OPENSOLR_EMAIL=your-value --env OPENSOLR_API_KEY=your-value -- uvx opensolr-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En OPENSOLR_API_KEY, OPENSOLR_EMAIL deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Opensolr MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
uv --versionSe instala una vez y sirve para todo lo que usa uv
Regístrate y crea una clave de Opensolr MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Rellena 1 ajuste(s)
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
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…
Las descripciones siguen en el inglés original.
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
Pega este comando y pulsa Enter
claude mcp add --scope user opensolr --env OPENSOLR_EMAIL=your-value --env OPENSOLR_API_KEY=your-value -- uvx opensolr-mcpCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Escribe /mcp en Claude Code
Deberías ver Opensolr MCP en la lista como conectado
Pruébalo
Usa Opensolr MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Opensolr MCP o muestra una herramienta de Opensolr MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Opensolr MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (OPENSOLR_EMAIL) · Instala Python (uv) en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Opensolr MCP para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "opensolr": { "command": "uvx", "args": [ "opensolr-mcp" ], "env": { "OPENSOLR_EMAIL": "your-value", "OPENSOLR_API_KEY": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En OPENSOLR_API_KEY, OPENSOLR_EMAIL deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Opensolr MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
uv --versionSe instala una vez y sirve para todo lo que usa uv
Regístrate y crea una clave de Opensolr MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Rellena 1 ajuste(s)
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
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…
Las descripciones siguen en el inglés original.
Escribe tu clave
En la configuración de Opensolr MCP, OPENSOLR_API_KEY, OPENSOLR_EMAIL está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Abre el chat de IA de Cursor en modo Agent
Pruébalo
Usa Opensolr MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Opensolr MCP o muestra una herramienta de Opensolr MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Opensolr MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (OPENSOLR_EMAIL) · Instala Python (uv) en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Opensolr MCP para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "opensolr": { "type": "stdio", "command": "uvx", "args": [ "opensolr-mcp" ], "env": { "OPENSOLR_EMAIL": "your-value", "OPENSOLR_API_KEY": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En OPENSOLR_API_KEY, OPENSOLR_EMAIL deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Opensolr MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
uv --versionSe instala una vez y sirve para todo lo que usa uv
Regístrate y crea una clave de Opensolr MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Rellena 1 ajuste(s)
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
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…
Las descripciones siguen en el inglés original.
Escribe tu clave
En la configuración de Opensolr MCP, OPENSOLR_API_KEY, OPENSOLR_EMAIL está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Abre el chat de IA de VS Code en modo Agent
Pruébalo
Usa Opensolr MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Opensolr MCP o muestra una herramienta de Opensolr MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Para desarrolladores: comandos de Terminal y configuración JSON
Instalado en tu computadora
Claude Code
claude mcp add --scope user opensolr --env OPENSOLR_EMAIL=your-value --env OPENSOLR_API_KEY=your-value -- uvx opensolr-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"opensolr": {
"command": "uvx",
"args": [
"opensolr-mcp"
],
"env": {
"OPENSOLR_EMAIL": "your-value",
"OPENSOLR_API_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"opensolr": {
"command": "uvx",
"args": [
"opensolr-mcp"
],
"env": {
"OPENSOLR_EMAIL": "your-value",
"OPENSOLR_API_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"opensolr": {
"type": "stdio",
"command": "uvx",
"args": [
"opensolr-mcp"
],
"env": {
"OPENSOLR_EMAIL": "your-value",
"OPENSOLR_API_KEY": "your-value"
}
}
}
}Valores que debes completar
OPENSOLR_EMAILobligatorio envOpensolr 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…OPENSOLR_API_KEYsecreto obligatorio envOpensolr 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…
Las descripciones siguen en el inglés original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
De un vistazo
- Descargas por semanai
- 40/sem
- Dominio verificado
- ✓ opensolr.com
- Conexión
- Se ejecuta en tu computadora
- Última versióni
- 0.8.1
- Categoríai
- Búsqueda y memoria de IA
- Publicado en el registroi
- 10 oct 2026
- Último cambio de códigoi
- 10 oct 2026
- Creador
- phpcip
- Paquetes
pypi: opensolr-mcp- Sitio web
- opensolr.com
- Estado en el registro
- Activo
Qué apps pueden usarlo
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Qué puede hacer
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisiones básicasi
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 15 nov 2026
- ✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con el dominio opensolr.com (el registro comprueba quién es dueño del dominio)
- ✓ Superada
Sigue en mantenimiento
Último cambio de código: hace 36 días
- ✓ Superada
Tiene licencia
Usa MIT
- – No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
- – No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
- … Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Vulnerabilidades publicadas (OSV.dev)
Aún no revisado
Creadores: pedir otra revisión o avisar de un dato erróneo
Conversación
Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Reseñas de usuarios
Aún no hay reseñas
Comparado con otros en Búsqueda y memoria de IAi
- Más estrellas que el 0% de los otros 6175 servidores de esta categoría
- Publicado en el registro más recientemente que el 51% de los otros 6175 servidores de esta categoría
- Revisiones básicas iguales o mejores que el 100% de los otros 6175 servidores de esta categoría
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Preguntas frecuentes
¿Es seguro Opensolr MCP?
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
¿Qué claves o códigos necesita?
Debes completar: OPENSOLR_API_KEY
¿Se ejecuta en mi computadora o en la nube?
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
¿Sigue en mantenimiento?
El repo de GitHub cambió por última vez hace 36 días, y la última versión (0.8.1) llegó al registro hace 36 días.
¿Qué apps pueden usarlo?
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
¿Qué puedo usar en su lugar?
En la misma categoría: OpenSEO, Exa, Mockserver, Microsoft Learn MCP, Docs
Alternativas parecidas
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Exa
Connect AI agents to Exa for web search, content fetching, and multi-step research.
Se ejecuta en la nube✓ del servicio · exa.aiProbado por el equipo de PopNx
Mockserver
Mock, record/replay, verify and chaos-test any HTTP, REST, gRPC or LLM dependency over MCP.
Se ejecuta en tu computadora✓ del servicio · mock-server.com
Microsoft Learn MCP
Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.
Se ejecuta en la nube✓ del servicio · microsoft.comProbado por el equipo de PopNx
Docs
Search and read Empryo's documentation. Read-only, no auth, no local access.
Se ejecuta en la nube✓ empryo.com
- OpenSEO — Funciona en la nube, sin instalar nada · Sin clave
- Exa — Funciona en la nube, sin instalar nada · Sin clave · En el directorio de Claude
- Mockserver — Se instala en tu equipo · Sin clave
- Microsoft Learn MCP — Funciona en la nube, sin instalar nada · Sin clave · En el directorio de Claude
- Docs — Funciona en la nube, sin instalar nada · Sin clave
README del creador
Abrir el README
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
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 (local files and folders too, PDFs page by page, scans through OCR), 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
| Tool | What it does |
|---|---|
opensolr_search | Hybrid (keyword + semantic) or pure semantic search, with Solr filters and a date range; a PDF comes back as its best page, with a link that opens it at that page |
opensolr_search_by_image | Search with a photo — Opensolr reads its visual labels, OCR text and any barcode/QR, then searches with those words (no image vector stored) |
opensolr_read_document | Read one result in full — a PDF page by page, any other document as one text |
opensolr_ai_answer | Grounded RAG answer: top hybrid hits become the LLM context — same pipeline as the hosted search UI |
opensolr_index_files | Index a local file or a whole folder: PDFs one document per page, Word / RTF / OpenDocument / text / HTML, scans and pictures through OCR |
opensolr_extract_text | Read local files without indexing them: text, OCR of their pictures, a PDF page by page |
opensolr_describe_image | What a picture shows (a sentence), the text printed on it, its labels and barcodes |
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 index in a region of opensolr_vector_regions (an environment id, or a short form like us matched against that live list) |
opensolr_vector_regions | Live list of vector-enabled regions |
opensolr_check_schema | Whether an index can do what each tool needs (Data Ingestion, vector and hybrid search, PDF pages, keyword search), and exactly why not |
opensolr_apply_schema | Install the Opensolr vector schema on an index of a vector region (replaces its configuration; force when it holds documents) |
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.comexport OPENSOLR_API_KEY=420b8b23e7b12dc8ab838932145a5065
mcp_demo_d1__dense is already loaded with 300 news articles, so search, filtering and grounded answers work the moment you connect. You also get the write path: create your own index on the account, ingest into it and query it. Deletion is not available on this shared key: no index here can be deleted or reconfigured by hand. Whatever you create is removed automatically after 3 days.
Know what you are working with:
- Anything you create there is deleted after 3 days. Automatically, without warning or export. That includes indexes you created and every document in them.
- The account is shared with everyone reading this. Your index is visible to them and they can add documents to it, as you can to theirs. Nobody can delete or reconfigure an index here (that is switched off for this key), but never put anything real, private or client-owned in it.
- The limits are per index, and deliberately small. 200 MB of bandwidth and 50 MB 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.
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 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.
Search with a photo
opensolr_search_by_image lets the agent search with a picture instead of a text query. Opensolr reads the image three ways — visual labels (what it depicts), OCR text (words printed on it), and any barcode / QR code — turns that into words, and runs the normal search. No image vector is stored.
opensolr_search_by_image(index="catalog__dense", image_path="/tmp/shelf.jpg",using="auto", k=5)
using: "auto" (engine's choice) | "meaning" (visual labels) |
"text" (OCR only) | "code" (exact barcode/QR) | "all" (everything)
-> { "read": {text, mode, labels, codes}, "results": [...] }
search_mode, mode, alpha, fresh_bias, filter_query, date_from, date_to and group_pages behave exactly as in opensolr_search.
Local files and folders: PDFs page by page, scans through OCR
opensolr_index_files indexes a file or a whole folder from the machine the server runs on. Each file is read on Opensolr's servers — its text, the text in its pictures (OCR, more than 100 languages), a short description of the pictures that have no text — and a PDF is indexed one document per page, so a search lands on the page that answers it instead of a 200-page file that mentions it somewhere. Word, RTF, OpenDocument, text, HTML and picture files (scans, photos of documents) are one document each.
opensolr_index_files(index="contracts__dense", path="~/Documents/contracts",pattern="*.pdf", metadata={"team": "legal"})
-> {"documents": [{path, source, uri, id}], "pending": [], "failed": [], "jobs": [...]}
- The bytes travel once: a file the account already sent (same content) is not uploaded again, and sending the same files again replaces their documents.
- Each document's
uriishttps://ingest.opensolr.com/ /, wheresourceis the file's path from the folder you sent (also inmeta_source); its date is the file's modification time, so date ranges work on local files too. - Big files are read in the background: whatever is still being read after
wait_secondscomes back underpending; call the tool again with the same path to index those (nothing is sent twice). - Pictures read by OCR count 0.5 of an AI request each; a file read before is free.
opensolr_extract_text does the same reading without indexing anything — the text of each file, a PDF as its pages (page, text, is_ocr, lang) — for an agent that wants to read a contract, a scanned invoice or a folder of reports itself.
opensolr_describe_image answers what a picture shows and what is written on it: caption (a sentence), text (OCR), labels and barcode / QR codes.
PDF pages in search results
On an index where PDFs are stored page by page (files indexed above, PDFs sent to Data Ingestion with rtf, PDFs found by the Web Crawler), opensolr_search returns each PDF once, as its best page:
{"title": "Master services agreement", "page": 14,"page_url": "https://example.com/msa.pdf#page=14", # opens the PDF at that page "document_id": "9f2c...", # for opensolr_read_document "more_pages": [{"page": 3, "page_url": "...#page=3"}, ...], # its other matching pages "matching_pages": 4, "uri": "https://example.com/msa.pdf", ...}
group_pages=false returns the pages as separate results. opensolr_read_document reads any result in full: a PDF as its pages in order (page_from / page_to), any other document as one text.
Searching a period
date_from and date_to (YYYY-MM-DD, both included, either one can be left out) keep only the documents dated in that period (creation_date). They combine with every other option, fresh_bias included.
Search operators
The query string understands the operators people already expect from a search box. They work in every mode — keyword, hybrid and pure vector.
| Operator | Meaning | Example |
|---|---|---|
"word1 word2" | Phrase — those words together, in that order | "machine learning" |
+word | Required — every result must contain it | +laptop 15 inch gaming |
+"word1 word2" | Required phrase | +"13 inch" |
-word | Excluded — drop any document containing it | laptop -refurbished |
-"word1 word2" | Excluded phrase | -"open box" |
They compose: +laptop +"13 inch" -refurbished returns only 13-inch laptops and never a refurbished one.
A prefixed term (+ or -, word or phrase) becomes a filter, applied to the whole result set. That matters as soon as a vector is involved: the semantic side of a hybrid search has no concept of negation, so left as query text -refurbished would actually pull refurbished listings *towards* the top rather than removing them. As a filter it binds every document, whichever side of the search found it, and the exclusion is absolute.
An unprefixed phrase ("machine learning" with no + in front) is a keyword-side relevance signal rather than a filter — use +"machine learning" when you need it enforced.
+ and - only count at the start of a word, so e-mail, covid-19 and 1+1 are searched for literally.
Notes
- Vector indexes live in the vector regions: the Opensolr servers that run the web crawler, whatever their Solr version. The list is live, never written in the package:
opensolr_vector_regionsreturns the regions that take new indexes right now (environment id, country, Solr version).location=takes an environment id from that list, or a short form such asus,deorfi, matched against the live list by environment id or country. Additional dedicated regions can be deployed on request (paid add-on): support@opensolr.com. - Every index is also plain Apache Solr with the native
/selectAPI — nothing is locked behind the tools. - Python sibling for LangChain:
langchain-opensolr· Product page: opensolr.com/langchain
How writing works (Data Ingestion API)
Writes go through Opensolr's Data Ingestion API — the same pipeline the Drupal and WordPress connectors use. It is asynchronous: documents are queued, then embeddings, sentiment, language and all crawler-identical derived fields are computed server-side, and documents become searchable within about a minute. Progress is visible in Control Panel → Data Ingestion — a per-job status board (queued / processing / completed / failed, with processed / success / failed document counts per job) — and via the ingest_status API. Each document's identity is its uri (the Solr id is md5(uri)): pass a real URL in metadata ({"uri": "https://..."}), or a deterministic one is synthesized from your id. Re-submitting the same uri updates the docume