Apache Solr

v1.0.0Databasesstable

MCP server for Apache Solr integration

solrmcpai-integration
Share:
10
Stars
0
Downloads
0
Weekly
0/5

What is Apache Solr?

Apache Solr is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for apache solr integration

MCP server for Apache Solr integration

This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP server for Apache Solr integration

Use Cases

Query and manage Apache Solr search indices through MCP.
adityamparikh

Maintainer

LicenseMIT
Languagejava
Versionv1.0.0
UpdatedFeb 2, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx solr

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Apache Solr

The Apache Solr MCP Server is a Java Spring Boot application that bridges Claude and other MCP-compatible AI assistants with Apache Solr search indices. It exposes tools for querying collections with full filter, facet, sort, and pagination support; indexing JSON documents; listing collections; retrieving schema definitions; and monitoring collection health. The server supports both stdio transport (for Claude Desktop integration) and HTTP transport (for development and testing). No API keys are required — security relies on network access controls and optionally OAuth2 for HTTP mode.

Prerequisites

  • Java 17 or higher installed (JDK recommended for building from source)
  • Apache Solr instance running and accessible (local Docker or remote server)
  • Gradle installed or use the included ./gradlew wrapper
  • Claude Desktop or another MCP-compatible client
  • Docker and Docker Compose (optional, for running Solr locally)
1

Start Apache Solr using Docker Compose

If you do not already have Solr running, the repository includes a docker-compose.yml to start a local instance. This launches Solr on the default port 8983.

git clone https://github.com/adityamparikh/solr-mcp-server.git
cd solr-mcp-server
docker-compose up -d
2

Build the MCP server JAR

Compile the Spring Boot application using the Gradle wrapper. This produces a JAR file in build/libs/ that you will reference in the MCP configuration.

./gradlew build
3

Test the server in HTTP mode

Before integrating with Claude Desktop, verify the server works by running it in HTTP mode. This exposes a local endpoint you can query directly for testing.

./gradlew bootRun --args='--spring.profiles.active=http'
4

Identify the built JAR path

Find the exact JAR filename produced by the build step. You will need the absolute path to this file for the Claude Desktop configuration.

ls build/libs/
# Example output: solr-mcp-server-0.0.1-SNAPSHOT.jar
5

Configure Claude Desktop

Add the Solr MCP server to your Claude Desktop config file. Use stdio profile for Claude Desktop integration. Set SOLR_URL to point to your Solr instance.

6

Restart Claude Desktop and verify

Quit and reopen Claude Desktop. Ask Claude to list your Solr collections to confirm the connection is active.

Apache Solr Examples

Client configuration

Claude Desktop configuration using the built JAR file with stdio transport. Replace the jar path and SOLR_URL with your actual values.

{
  "mcpServers": {
    "solr-search-mcp": {
      "command": "java",
      "args": ["-jar", "/absolute/path/to/solr-mcp-server/build/libs/solr-mcp-server-0.0.1-SNAPSHOT.jar"],
      "env": {
        "SOLR_URL": "http://localhost:8983/solr/",
        "PROFILES": "stdio"
      }
    }
  }
}

Prompts to try

These queries use the search, listCollections, getSchema, and getCollectionStats tools exposed by the server.

- "List all available Solr collections in my instance."
- "Search the 'products' collection for items where category is 'electronics', return 10 results."
- "What is the schema definition for the 'books' collection?"
- "Index this JSON document into the 'logs' collection: [{\"id\": \"1\", \"message\": \"test event\"}]"
- "Check the health status of my 'users' Solr collection."

Troubleshooting Apache Solr

Server fails to connect to Solr with connection refused error

Verify your Solr instance is running and reachable at the URL set in SOLR_URL. Test directly: curl http://localhost:8983/solr/admin/collections?action=LIST. If using Docker, ensure the container is running with: docker ps | grep solr.

Gradle build fails with Java version errors

Ensure you are using Java 17 or higher: java -version. If you have multiple Java versions installed, set JAVA_HOME to point to Java 17+: export JAVA_HOME=$(/usr/libexec/java_home -v 17) on macOS.

Claude Desktop shows the server as disconnected

The JAR path in the config must be absolute, not relative. Run 'pwd' in the solr-mcp-server directory and prepend that path to the JAR filename. Also confirm PROFILES is set to 'stdio' not 'http' in the env block.

Frequently Asked Questions about Apache Solr

What is Apache Solr?

Apache Solr is a Model Context Protocol (MCP) server that mcp server for apache solr integration It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Apache Solr?

Follow the installation instructions on the Apache Solr GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Apache Solr?

Apache Solr works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Apache Solr free to use?

Yes, Apache Solr is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Databases MCP Servers

Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "solr": { "command": "npx", "args": ["-y", "solr"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Apache Solr?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides