hello-spring

Hello Spring MCP Server provides a lightweight Spring Boot-based MCP server implementation. It is started locally using the Gradle wrapper, which boots the Spring application and exposes the MCP server endpoints as defined in the project. You can use the standard Spring Boot startup to run the server and then interact with the MCP protocol compatible tools that your environment supports. The server is designed to be extended via typical Spring configuration and branches like ecs or agentcore indicate deployment and integration options beyond a local run.

Prerequisites:

• Java Development Kit (JDK) 11 or newer
• Git installed on your machine
• Gradle wrapper included in the repository (gradlew)

1. Clone the repository: git clone https://github.com/your-org/hello-spring-mcp-server.git cd hello-spring-mcp-server

2. Ensure the Gradle wrapper is executable (if on Unix-like systems): chmod +x gradlew

3. Run the server locally: ./gradlew bootRun

4. Verify the server is running by checking logs in the console, or by hitting the configured MCP endpoints once the server is up.

Note: For deployment, there are branches available (e.g., ecs, agentcore) that provide alternative deployment configurations.

Tips:

• If you modify configuration, ensure your JAVA_HOME is set to a valid JDK installation.
• The bootRun task will start the embedded server; for production deployments, consider building a runnable JAR via ./gradlew bootJar and packaging accordingly.
• Branches like ecs and agentcore may contain CI/CD or containerized deployment definitions for cloud or orchestrated environments.

Common issues:

• Java version incompatibilities: ensure a compatible JDK is used (verify with java -version).
• Network/port conflicts: confirm the server port (default Spring Boot port 8080) is available.
• Missing gradlew executable: ensure the wrapper has execute permissions and that the repository includes the wrapper files.