epugh commented on code in PR #1: URL: https://github.com/apache/solr-mcp/pull/1#discussion_r2444889591
########## README.md: ########## @@ -0,0 +1,461 @@ +# Solr MCP Server + +A Spring AI Model Context Protocol (MCP) server that provides tools for interacting with Apache Solr. This server +enables AI assistants like Claude to search, index, and manage Solr collections through the MCP protocol. Review Comment: Github has some annotaitons that work great to add a call out to the user. https://github.com/orgs/community/discussions/16925. I think this is shwere we should add it, picking up on @janhoy suggestion that this be labeled Incubating. ########## README.md: ########## @@ -0,0 +1,461 @@ +# Solr MCP Server + +A Spring AI Model Context Protocol (MCP) server that provides tools for interacting with Apache Solr. This server +enables AI assistants like Claude to search, index, and manage Solr collections through the MCP protocol. + +## Overview + +This project provides a set of tools that allow AI assistants to interact with Apache Solr, a powerful open-source +search platform. By implementing the Spring AI MCP protocol, these tools can be used by any MCP-compatible client, +including Claude Desktop. The project uses SolrJ, the official Java client for Solr, to communicate with Solr instances. + +The server provides the following capabilities: + +- Search Solr collections with advanced query options +- Index documents into Solr collections +- Manage and monitor Solr collections +- Retrieve and analyze Solr schema information + +### Transport Profiles + +The server supports two transport modes: + +- **STDIO (Standard Input/Output)** - Recommended for local development and production use with Claude Desktop. This is + the default and most secure option for local deployments. +- **HTTP (Streamable HTTP)** - For testing with MCP Inspector and remote deployments. ⚠️ **Note:** HTTP + mode is inherently insecure without additional security measures (see Security Considerations below). + +## Prerequisites + +- Java 25 or higher +- Docker and Docker Compose (for running Solr) +- Gradle 9.1.0+ (wrapper included in project) + +## Installation and Setup + +### 1. Clone the repository Review Comment: I think the readme needs to move into "Installation" for a released version, and then "How to develop this" that goes into cloinging and compiling etc. Our goal is that this should be a released artifact. Though honestly, that doens't need to happen now, again, we can have seperate prs ;-). ########## README.md: ########## @@ -0,0 +1,461 @@ +# Solr MCP Server + +A Spring AI Model Context Protocol (MCP) server that provides tools for interacting with Apache Solr. This server +enables AI assistants like Claude to search, index, and manage Solr collections through the MCP protocol. + +## Overview + +This project provides a set of tools that allow AI assistants to interact with Apache Solr, a powerful open-source +search platform. By implementing the Spring AI MCP protocol, these tools can be used by any MCP-compatible client, +including Claude Desktop. The project uses SolrJ, the official Java client for Solr, to communicate with Solr instances. + +The server provides the following capabilities: + +- Search Solr collections with advanced query options +- Index documents into Solr collections +- Manage and monitor Solr collections +- Retrieve and analyze Solr schema information + +### Transport Profiles + +The server supports two transport modes: + +- **STDIO (Standard Input/Output)** - Recommended for local development and production use with Claude Desktop. This is + the default and most secure option for local deployments. +- **HTTP (Streamable HTTP)** - For testing with MCP Inspector and remote deployments. ⚠️ **Note:** HTTP + mode is inherently insecure without additional security measures (see Security Considerations below). + +## Prerequisites + +- Java 25 or higher +- Docker and Docker Compose (for running Solr) Review Comment: Docker is only needed for the demo right? to play with it? I *would* really love to see a tutorial added to the ref guide showing off this tool. https://solr.apache.org/guide/solr/latest/getting-started/solr-tutorial.html is wehre to link it. The blog is good, the readme is good, but the ref guide is meant to cover everything, and this is a cool thing to add to our tutoriazls. If you do that, you may find that we don't even need the docker/docker compose here... not sure on that. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
