MCP Sample Java Application

MCP Sample Java 应用

这是一个使用 Spring AI 实现 MCP（Model Controller Provider）服务的最小化 Spring Boot 应用。
该应用旨在用作客户端应用的外部 MCP 服务。

---

🚀 开始使用

1. 克隆项目

    git clone [email protected]:Saularch97/mcp-java-sample.git
    cd openmeteomcp

2. 构建项目

  mvn clean package

输出文件位于 target/openmeteomcp-0.0.1-SNAPSHOT.jar

⚙️ 客户端配置

要从客户端运行该服务，请插入以下配置：

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

将 <PATH_TO_YOUR_PROJECT> 替换为项目目录的实际路径。

📦 项目依赖

该项目依赖以下 Spring AI starter 模块：

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

🧰 要求

• Java 21
• Maven 3.8+

要使用该项目，只需连接一个客户端，例如 Cursor、ClaudeDesktop、Vscode 等。