# agent-mcp-study

**Repository Path**: e4glet/agent-mcp-study

## Basic Information

- **Project Name**: agent-mcp-study
- **Description**: 这是一个面向教学的大模型Agent代理后端系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-07
- **Last Updated**: 2026-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Agent MCP 系统

## 项目介绍
这是一个面向教学的大模型Agent代理后端系统，基于FastAPI和原生MCP（模型上下文协议）实现。项目旨在帮助学生理解大模型Agent开发的基本原理和实现方式，通过实际的代码示例展示如何构建和扩展MCP服务器。

### 项目展示
![alt text](image1.png)

![alt text](image2.png)

### 系统组成
1. MCP服务器：提供计算器、文件操作、天气查询、系统时间等基础功能
2. MCP桥接器：统一的API接口，管理和调度各MCP服务器
3. Vue3前端：直观的用户界面，支持自然语言交互和直接工具调用

## 项目结构
``` text
agent-mcp-study/
├── miniconda3/                    # Python 3.10.16                      
├── mcp_servers/                   # Python 后端
│   ├── calculator.py
│   ├── file_operations.py
│   ├── system_time.py             # 系统时间服务
│   └── utils.py
├── mcp_bridge.py
├── run_servers.py
├── 一键启动.bat
├── requirements.txt
└── vue3-agent-mcp/                # Vue3 前端
    ├── public/
    ├── src/
    │   ├── components/
    │   │   ├── ChatWindow.vue
    │   │   └── FloatingAI.vue
    │   ├── composables/
    │   │   ├── useChat.js
    │   │   └── useMCP.js
    │   ├── views/
    │   │   └── HomeView.vue
    │   └── App.vue
    └── package.json
```

## 项目使用说明
### 1. 环境初始化
``` bash
miniconda3\python.exe -m pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
```

### 2. 项目启动
直接双击运行一键端或者在终端中的项目目录下执行下面命令：
```bash
miniconda3\python.exe run_servers.py
```


### 3. 功能使用
#### 使用计算器工具：
```bash
curl -X POST http://localhost:8000/execute \
  -H "Content-Type: application/json" \
  -d '{
    "server": "calculator",
    "tool": "add",
    "parameters": {
      "a": 10,
      "b": 5
    }
  }'
```

#### 获取当前时间
```bash
curl -X POST http://localhost:8000/execute \
  -H "Content-Type: application/json" \
  -d '{
    "server": "system_time",
    "tool": "get_current_time",
    "parameters": {
      "format": "%Y年%m月%d日 %H时%M分%S秒",
      "timezone_offset": 8
    }
  }'
```

#### 获取系统信息
```bash
curl -X POST http://localhost:8000/execute \
  -H "Content-Type: application/json" \
  -d '{
    "server": "system_time",
    "tool": "get_system_info",
    "parameters": {}
  }'
```

#### 查看API文档：
打开浏览器访问：
- Swagger UI: http://localhost:8000/docs
- ReDoc: http://localhost:8000/redoc

## 项目特点
1. 简洁易懂：代码结构清晰，适合教学使用
2. 模块化设计：每个MCP服务器独立，便于扩展
3. 完整文档：基于FastAPI自动生成API文档
4. 错误处理：包含基本的错误处理和验证
5. 安全考虑：文件操作有基本的安全限制