# java-ai-stevecode

**Repository Path**: SongXianYang/java-ai-stevecode

## Basic Information

- **Project Name**: java-ai-stevecode
- **Description**: ai应用java版本
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-21
- **Last Updated**: 2026-05-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Java AI SteveCode

基于 Spring AI 和 MCP（Model Context Protocol）的 Java AI 项目。

## 项目简介

本项目演示了如何使用 Spring AI 框架实现 MCP 协议的服务器端和客户端，支持 AI 模型调用外部工具（如天气查询、紫外线查询等）。

## 技术栈

- Java 17
- Spring Boot 3.5.14
- Spring AI 1.1.6
- Spring AI Alibaba 1.1.2.0
- Maven

## 项目结构

```
java-ai-stevecode/
├── mcp-server/          # MCP 服务器端，提供工具服务
├── mcp-client/          # MCP 客户端，调用 AI 模型并使用服务器工具
└── pom.xml              # 父 POM 文件
```

### 模块说明

- **mcp-server**: MCP 协议服务器，注册并暴露各种工具（如天气查询工具）
- **mcp-client**: MCP 协议客户端，连接 AI 模型（DashScope）并通过 MCP 协议调用服务器工具

## 快速开始

### 环境要求

- JDK 17 或更高版本
- Maven 3.6+

### 构建项目

```bash
mvn clean install
```

### 运行 MCP Server

```bash
cd mcp-server
mvn spring-boot:run
```

### 运行 MCP Client

```bash
cd mcp-client
mvn spring-boot:run
```

## 配置说明

### MCP Client 配置

在 `mcp-client/src/main/resources/application.yml` 中配置：

- AI 模型 API Key（DashScope）
- MCP Server 连接地址

### MCP Server 配置

在 `mcp-server/src/main/resources/application.yml` 中配置服务器端口等参数。

## 功能特性

- MCP 协议服务器实现
- MCP 协议客户端实现
- 天气查询工具
- 紫外线强度查询工具
- 基于 Spring AI 的 AI 模型集成

## 开发指南

### 添加新工具

在 `mcp-server/src/main/java/org/song/tools/` 目录下创建新的工具类，使用 Spring AI 的工具注解进行注册。

## 许可证

本项目采用 MIT 许可证。