内容
这里是 `mcp-agent-example` 项目的基本 `README.md`:
# MCP Agent 示例
## 概述
`mcp-agent-example` 是一个基于 Java 的项目,使用 Maven 和 Spring Boot 构建。它作为一个示例实现,展示了一个与 MCP(多客户端平台)工具和 AI 桥接交互的代理,执行各种任务,如查询天气信息、进行计算和处理推理步骤。
## 特性
- 与 MCP 工具集成,用于天气信息和计算。
- 支持 AI 桥接,用于推理和自然语言处理。
- 可通过 `application.yml` 配置。
- 使用 `closeGracefully()` 进行优雅的资源管理。
## 需求
- **Java**: JDK 11 或更高版本
- **Maven**: 3.6 或更高版本
- **Spring Boot**: 2.x 或更高版本
## 安装
1. 克隆代码库:
```bash
git clone https://github.com/your-repo/mcp-agent-example.git
```
2. 进入项目目录:
```bash
cd mcp-agent-example
```
3. 构建项目:
```bash
mvn clean install
```
## 配置
编辑位于 `src/main/resources` 的 `application.yml` 文件,以配置服务器和工具:
```yaml
server:
port: 5678
address: 0.0.0.0
spring:
application:
name: agent-sample-with-mcp
ai:
bridge:
zhipu:
api_key: your_key
mcp:
getRealWeatherInfo:
tool-name: getRealWeatherInfo
base-url: http://localhost:8080
api-key: your_key
calculate:
tool-name: calculate
base-url: http://localhost:8080
api-key: your_key
queryAllValidWeatherLocation:
tool-name: queryAllValidWeatherLocation
base-url: http://localhost:8080
api-key: your_key
```
将 `your_key` 和 `http://localhost:8080` 替换为您的实际 API 密钥和 MCP 服务器 URL。
## 使用
1. 启动应用程序:
```bash
mvn spring-boot:run
```
2. 访问服务器:
```
http://localhost:5678
```
3. 示例 HTTP 请求:
```http
GET http://localhost:5678/server?从杭州到广州怎么样
```
## 项目结构
- `src/main/java`: 包含 Java 源代码。
- `common`: 包含核心类,如 `ReasoningStep`。
- `llm`: 处理 AI 桥接交互。
- `mcp`: 管理 MCP 工具的选择和执行。
- `src/main/resources`: 包含配置文件,如 `application.yml`。
## 关键类
### `ReasoningStep`
处理推理逻辑,包括附加提示、与工具交互和管理上下文。
### `Tool`
表示具有缓存功能的 MCP 工具。
## 贡献
欢迎贡献!请提交拉取请求或打开问题以进行任何改进或错误修复。