# bamboo-mcp

**Repository Path**: sunney/bamboo-mcp

## Basic Information

- **Project Name**: bamboo-mcp
- **Description**: No description available
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-13
- **Last Updated**: 2025-12-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Bamboo MCP 项目

这是一个基于Spring Boot的MCP项目，包含server和client两个模块。

## 项目结构

```
bamboo-mcp/
├── bamboo-mcp-server/     # 服务端模块
│   ├── src/main/java/com/bamboo/mcp/server/
│   │   ├── controller/    # 控制器层
│   │   ├── service/       # 服务层
│   │   ├── config/        # 配置类
│   │   └── BambooMcpServerApplication.java  # 启动类
│   └── src/main/resources/
│       └── application.properties           # 配置文件
├── bamboo-mcp-client/     # 客户端模块
│   ├── src/main/java/com/bamboo/mcp/client/
│   │   ├── controller/    # 控制器层
│   │   ├── service/       # 服务层
│   │   ├── config/        # 配置类
│   │   └── BambooMcpClientApplication.java  # 启动类
│   └── src/main/resources/
│       └── application.properties           # 配置文件
└── pom.xml               # 根项目配置
```

## 功能说明

### bamboo-mcp-server 模块

1. **天气查询接口**
   - 接口地址: `GET /weather?city={城市名}`
   - 调用高德地图API查询天气信息

2. **时间查询接口**
   - 接口地址: `GET /time`
   - 返回当前系统时间，格式为: yyyy-MM-dd HH:mm:ss

### bamboo-mcp-client 模块

1. **调用天气接口**
   - 接口地址: `GET /client/weather?city={城市名}`

2. **调用时间接口**
   - 接口地址: `GET /client/time`

## 技术要求

- Java 17+
- Maven 3.6+
- Spring Boot 3.1.0

## 配置说明

在运行server模块之前，需要在`bamboo-mcp-server/src/main/resources/application.properties`文件中配置高德地图API Key：

```properties
server.port=8080
# 高德地图API Key配置
gaode.api.key=your-gaode-api-key-here
```

## 运行项目

1. 编译项目：
   ```bash
   mvn clean install
   ```

2. 启动server模块：
   ```bash
   cd bamboo-mcp-server
   mvn spring-boot:run
   ```

3. 启动client模块：
   ```bash
   cd bamboo-mcp-client
   mvn spring-boot:run
   ```

## 接口测试

### Server端接口

1. 查询天气：
   ```
   GET http://localhost:8080/weather?city=北京
   ```

2. 查询时间：
   ```
   GET http://localhost:8080/time
   ```

### Client端接口

1. 通过client查询天气：
   ```
   GET http://localhost:8081/client/weather?city=上海
   ```

2. 通过client查询时间：
   ```
   GET http://localhost:8081/client/time
   ```

## MCP 2.0 协议说明

本项目遵循MCP 2.0标准协议，确保与其他MCP兼容系统的互操作性。

## 关于Spring AI

当前版本移除了Spring AI依赖，因为存在依赖解析问题。后续版本将重新集成Spring AI以支持自然语言处理功能。