feat：恢复mcp模块动态agent

2026-04-10 10:17:31 +00:00 · 2026-03-08 22:41:24 +08:00
parent f160ec714b
commit 84dbc2cfbf
54 changed files with 1150 additions and 793 deletions
--- a/ruoyi-modules/ruoyi-chat/docs/frontend-guide.md
+++ b/ruoyi-modules/ruoyi-chat/docs/frontend-guide.md
@@ -0,0 +1,244 @@
+# MCP工具管理前端开发指南
+
+## 前置条件
+
+- Node.js >= 16.0
+- Vue 3
+- Element Plus
+- ECharts (用于图表展示)
+- Axios (用于HTTP请求)
+
+## 安装依赖
+
+```bash
+npm install element-plus echarts axios
+```
+
+## 项目结构
+
+```
+ruoyi-ui/
+├── src/
+│   ├── api/
+│   │   └── mcp/
+│   │       └── tool.js          # API接口
+│   ├── views/
+│   │   └── mcp/
+│   │       ├── tool/
+│   │       │   └── index.vue    # 工具管理页面
+│   │       ├── market/
+│   │       │   └── index.vue    # 市场管理页面
+│   │       └── log/
+│   │           └── index.vue    # 调用日志页面
+│   └── utils/
+│       └── request.js           # Axios封装
+```
+
+## 菜单配置
+
+在系统菜单管理中添加以下菜单：
+
+### 1. MCP工具管理
+
+| 字段 | 值 |
+|------|-----|
+| 菜单名称 | MCP工具管理 |
+| 菜单类型 | 目录 |
+| 显示顺序 | 1 |
+| 路由地址 | mcp |
+| 组件路径 | |
+
+#### 子菜单：工具列表
+
+| 字段 | 值 |
+|------|-----|
+| 菜单名称 | 工具列表 |
+| 菜单类型 | 菜单 |
+| 显示顺序 | 1 |
+| 路由地址 | tool |
+| 组件路径 | mcp/tool/index |
+| 权限标识 | mcp:tool:list |
+
+#### 子菜单：市场管理
+
+| 字段 | 值 |
+|------|-----|
+| 菜单名称 | 市场管理 |
+| 菜单类型 | 菜单 |
+| 显示顺序 | 2 |
+| 路由地址 | market |
+| 组件路径 | mcp/market/index |
+| 权限标识 | mcp:market:list |
+
+#### 子菜单：调用日志
+
+| 字段 | 值 |
+|------|-----|
+| 菜单名称 | 调用日志 |
+| 菜单类型 | 菜单 |
+| 显示顺序 | 3 |
+| 路由地址 | log |
+| 组件路径 | mcp/log/index |
+| 权限标识 | mcp:tool:query |
+
+## 权限配置
+
+| 权限标识 | 权限名称 | 说明 |
+|----------|----------|------|
+| mcp:tool:list | 工具列表 | 查看工具列表 |
+| mcp:tool:query | 工具查询 | 查看工具详情 |
+| mcp:tool:add | 工具新增 | 新增工具 |
+| mcp:tool:edit | 工具修改 | 修改工具 |
+| mcp:tool:remove | 工具删除 | 删除工具 |
+| mcp:tool:export | 工具导出 | 导出工具数据 |
+| mcp:market:list | 市场列表 | 查看市场列表 |
+| mcp:market:query | 市场查询 | 查看市场详情 |
+| mcp:market:add | 市场新增 | 新增市场 |
+| mcp:market:edit | 市场修改 | 修改市场 |
+| mcp:market:remove | 市场删除 | 删除市场 |
+
+## 路由配置
+
+在路由配置文件中添加：
+
+```javascript
+{
+  path: '/mcp',
+  component: Layout,
+  redirect: '/mcp/tool',
+  name: 'Mcp',
+  meta: { title: 'MCP工具管理', icon: 'tools' },
+  children: [
+    {
+      path: 'tool',
+      name: 'McpTool',
+      component: () => import('@/views/mcp/tool/index'),
+      meta: { title: '工具列表', icon: 'tool' }
+    },
+    {
+      path: 'market',
+      name: 'McpMarket',
+      component: () => import('@/views/mcp/market/index'),
+      meta: { title: '市场管理', icon: 'shop' }
+    },
+    {
+      path: 'log',
+      name: 'McpLog',
+      component: () => import('@/views/mcp/log/index'),
+      meta: { title: '调用日志', icon: 'document' }
+    }
+  ]
+}
+```
+
+## API请求配置
+
+确保Axios请求拦截器正确配置：
+
+```javascript
+// src/utils/request.js
+import axios from 'axios'
+import { ElMessage } from 'element-plus'
+
+const service = axios.create({
+  baseURL: process.env.VUE_APP_BASE_API,
+  timeout: 30000
+})
+
+// 请求拦截器
+service.interceptors.request.use(
+  config => {
+    // 添加token
+    const token = localStorage.getItem('Admin-Token')
+    if (token) {
+      config.headers['Authorization'] = 'Bearer ' + token
+    }
+    return config
+  },
+  error => {
+    return Promise.reject(error)
+  }
+)
+
+// 响应拦截器
+service.interceptors.response.use(
+  response => {
+    const res = response.data
+    if (res.code !== 200) {
+      ElMessage.error(res.msg || '请求失败')
+      return Promise.reject(new Error(res.msg || '请求失败'))
+    }
+    return res
+  },
+  error => {
+    ElMessage.error(error.message)
+    return Promise.reject(error)
+  }
+)
+
+export default service
+```
+
+## 开发步骤
+
+1. **复制代码文件**
+   - 将 `tool.js` 复制到 `src/api/mcp/` 目录
+   - 将 `*.vue` 文件复制到对应的视图目录
+
+2. **安装依赖**
+   ```bash
+   npm install element-plus echarts
+   ```
+
+3. **配置路由**
+   - 在路由配置中添加MCP相关路由
+
+4. **配置菜单**
+   - 在系统管理中添加菜单
+
+5. **配置权限**
+   - 在系统管理中添加权限标识
+
+6. **测试功能**
+   - 启动开发服务器
+   - 测试各项功能
+
+## 注意事项
+
+1. **工具类型说明**
+   - BUILTIN: 内置工具（系统自带，不可编辑）
+   - LOCAL: 本地STDIO工具（通过命令行启动）
+   - REMOTE: 远程HTTP工具（通过网络连接）
+
+2. **配置JSON格式**
+   - LOCAL类型: `{"command": "npx", "args": ["-y", "@example/tool"], "env": {}}`
+   - REMOTE类型: `{"baseUrl": "http://localhost:8080/mcp"}`
+
+3. **错误处理**
+   - 工具连接测试可能超时，请合理设置超时时间
+   - 删除工具前请确认没有正在运行的Agent使用该工具
+
+4. **性能优化**
+   - 调用日志数据量大时，建议使用分页加载
+   - 图表数据建议缓存处理，避免频繁请求
+
+## 常见问题
+
+### 1. 跨域问题
+在 `vue.config.js` 中配置代理：
+```javascript
+devServer: {
+  proxy: {
+    '/api': {
+      target: 'http://localhost:8080',
+      changeOrigin: true
+    }
+  }
+}
+```
+
+### 2. 图表不显示
+确保ECharts容器有固定高度，并在数据加载后初始化图表。
+
+### 3. 权限不生效
+检查菜单权限配置和后端接口权限注解是否一致。