# MCP Client Vue - 版本信息

## 当前版本：v1.0.2

**发布日期**: 2025-10-14

**核心功能**: AI + MCP 工具调用集成

---

## 版本历史

### v1.0.2 (2025-10-14) - 工具调用
- 🎯 **重大功能**: 完整的 MCP 工具调用集成
- 🔧 AI 智能识别并调用 MCP 工具
- 🔄 流式工具执行体验
- 📋 OpenAI Function Calling 格式支持
- 🐛 类型导入和路径冲突修复

**核心改进**:
- MCPClientService 工具列表获取
- chatService 工具调用执行逻辑
- modelServiceManager 流式解析增强
- 完整的多轮对话支持（AI → Tool → AI）

### v1.0.1 (2025-10-14) - 稳定性提升
- 🚀 服务器管理系统完善
- 🔄 自动重连机制
- 🐛 编辑按钮、模态框、表单数据修复
- 📡 HTTP/SSE 双协议支持优化

### v1.0.0 (2025-10-12) - 初始发布
- 🎯 MCP 客户端基础功能
- 📡 HTTP 和 SSE 双传输协议
- 🎨 Vue 3 + TypeScript + Naive UI
- 🔧 服务器连接管理
- 📦 工具、资源、提示词支持

---

## 技术栈

- **前端框架**: Vue 3.4.15
- **UI 组件**: Naive UI 2.43.1
- **状态管理**: Pinia 2.1.7
- **构建工具**: Vite 5.0.8
- **类型检查**: TypeScript 5.3.3
- **路由**: Vue Router 4.2.5

---

## 快速开始

```bash
# 克隆项目
git clone [your-repo-url]
cd mcp-client-vue

# 安装依赖
cd web && npm install

# 启动开发服务器
npm run dev

# 访问应用
open http://localhost:5173
```

---

## 功能清单

### ✅ 已实现
- [x] MCP 服务器连接管理（HTTP/SSE）
- [x] 服务器状态实时监控
- [x] 自动重连机制
- [x] 工具调用执行
- [x] AI 智能工具调用
- [x] 流式对话体验
- [x] 多模型服务支持
- [x] 工具格式自动转换
- [x] 完整的错误处理

### 🚧 开发中
- [ ] 工具调用历史记录
- [ ] 工具执行超时控制
- [ ] 批量工具调用优化
- [ ] 工具调用权限管理
- [ ] 工具调用性能监控

### 🔮 计划中
- [ ] 资源管理界面
- [ ] 提示词编辑器
- [ ] 工具调用可视化
- [ ] 性能分析面板
- [ ] 插件系统

---

## 升级指南

### 从 v1.0.1 升级到 v1.0.2

```bash
# 拉取最新代码
git pull origin main

# 更新依赖（如果有变化）
cd web && npm install

# 启动开发服务器
npm run dev
```

**重要变更**:
- 新增工具调用功能，需要配置支持 Function Calling 的 AI 服务
- 确保 MCP 服务器实现了 `tools/list` 和 `tools/call` 接口
- 工具的 inputSchema 需要符合 JSON Schema 规范

---

## 使用说明

### 配置 AI 服务
1. 进入"模型服务"设置
2. 添加支持 Function Calling 的 AI 服务（OpenAI、火山引擎等）
3. 配置 API Key 和 Base URL
4. 测试连接并启用

### 配置 MCP 服务器
1. 进入"MCP 设置"
2. 添加提供工具的 MCP 服务器
3. 选择 HTTP 或 SSE 传输类型
4. 测试连接并启用

### 使用工具调用
1. 在对话界面选择模型
2. 选择包含工具的 MCP 服务器
3. 发送需要工具辅助的消息
4. AI 会自动调用相关工具并整合结果

---

## 性能指标

- **首字响应**: < 1s
- **流式延迟**: 10-30ms
- **工具调用**: 根据工具复杂度
- **内存占用**: < 100MB
- **包大小**: ~500KB (gzipped)

---

## 支持的 AI 服务

- ✅ OpenAI (GPT-3.5, GPT-4)
- ✅ 火山引擎 (Doubao)
- ✅ 阿里云 (通义千问)
- ✅ 本地模型 (Ollama 等 OpenAI 兼容服务)
- ✅ Azure OpenAI
- ✅ Claude (Anthropic)

---

## 问题反馈

- 📖 [完整文档](./README.md)
- 📋 [更新日志](./CHANGELOG.md)
- 🐛 [问题报告](./CURRENT_STATUS.md)
- 📚 [开发指南](./DEVELOPMENT_GUIDE.md)

---

**MCP Client Vue v1.0.2 - 让 AI 和 MCP 工具完美协作！** 🚀🔧