mcp-java-sample

mcp-java-sample

1
developer_tools

This project is a Spring Boot application that implements a Model Controller Provider server using Spring AI. It enables external MCP server functionality for client applications with dependencies on specific Spring modules.

MCP Sample Java Application

This is a minimal Spring Boot application implementing an MCP (Model Controller Provider) server using Spring AI.
It is designed to be used as an external MCP server for client applications.

🚀 Getting Started

1. Clone the Project

    git clone git@github.com:Saularch97/mcp-java-sample.git
    cd openmeteomcp

2. Build the Project

  mvn clean package

The output will be located at target/openmeteomcp-0.0.1-SNAPSHOT.jar

⚙️ Client Configuration

To run the server from your client, insert the following configuration:

{
  "mcpServers": {
    "mcpopenmeteo": {
      "command": "java",
      "args": [
        "-jar",
        "<PATH_TO_YOUR_PROJECT>/openmeteomcp/target/openmeteomcp-0.0.1-SNAPSHOT.jar",
        "--port",
        "8080",
        "--host",
        "localhost"
      ]
    }
  }
}

Replace <PATH_TO_YOUR_PROJECT> with the actual path to your project directory.

📦 Project Dependencies

The project depends on the following Spring AI starter module:

<dependencies>
    <dependency>
        <groupId>org.springframework.ai</groupId>
        <artifactId>spring-ai-starter-mcp-server-webmvc</artifactId>
    </dependency>
</dependencies>

🧰 Requirements

  • Java 21
  • Maven 3.8+

To use the project just connect with an client, Cursor, ClaudeDesktop, Vscode etc.

img.png