iconsulting

Commit Graph

Author	SHA1	Message	Date
hailin	714a674818	feat(mcp): add MCP Server management — backend API + admin UI 实现完整的 MCP (Model Context Protocol) 服务器管理功能，包括后端 API 和管理界面。 ## 后端 (conversation-service) ### MCP 混合架构核心 (新增) - mcp.types.ts: MCP 类型定义 (McpServerConfig, McpToolDefinition, McpConnectionState 等) - mcp-config.service.ts: 配置解析 — 支持环境变量 MCP_SERVERS 和租户级配置 - mcp-client.service.ts: MCP 客户端 — 连接管理、工具发现、工具执行、运行时增删改 - mcp.module.ts: @Global NestJS 模块，注册 MCP 服务 + TypeORM 实体 + Repository ### 数据持久化 (新增) - 20260206_add_mcp_server_configs.sql: 数据库迁移 — mcp_server_configs 表 - mcp-server-config.orm.ts: TypeORM 实体 (tenant_id 支持多租户) - mcp-server-config.repository.ts: Repository 层 (CRUD + ORM→McpServerConfig 转换) ### Admin API (新增) - admin-mcp.controller.ts: 11 个管理端点，路由前缀 conversations/admin/mcp - GET /overview — 统计信息 (服务器总数、已连接、错误、工具总数) - GET/POST /servers — 列表 + 创建 - GET/PUT/DELETE /servers/:id — 详情 + 更新 + 删除 - POST /servers/:id/connect — 手动连接 - POST /servers/:id/disconnect — 手动断开 - GET /servers/:id/tools — 查看已发现工具 - POST /servers/:id/test — 测试连接 - POST /test-config — 测试未保存的配置 ### 已有文件修改 - coordinator-tools.ts: getToolsForClaudeAPI() 支持 additionalTools 可选参数 - agent-loop.ts: 支持 additionalTools + additionalConcurrencyMap 透传 - coordinator-agent.service.ts: 注入 McpClientService，工具路由加 MCP 分支 - agents.module.ts: 导入 McpModule - conversation.module.ts: 注册 AdminMcpController ## 前端 (admin-client) ### API + Hooks (新增) - mcp.api.ts: Axios API 客户端 + 完整 TypeScript 类型定义 - useMcp.ts: 10 个 React Query hooks (queries + mutations) ### UI 页面 (新增) - McpPage.tsx: 主页面 — 统计卡片 + 服务器表格 + 操作按钮 - ServerFormDrawer.tsx: 创建/编辑表单 — 基本信息、传输配置、高级设置、连接测试 - ServerDetailDrawer.tsx: 详情抽屉 — 配置展示、工具浏览 (Collapse + JSON Schema) ### 路由 + 导航 - App.tsx: 添加 /mcp 路由 - MainLayout.tsx: 侧边栏添加 "MCP 服务器" 菜单项 (ApiOutlined 图标) ## 依赖 - @modelcontextprotocol/sdk: ^1.0.0 (MCP 协议 SDK) ## 架构设计 - 混合架构: 16 个内置工具保持不变 + MCP 工具动态发现/热插拔 - 工具名前缀 mcp__{serverId}__{toolName} 确保零冲突 - 优雅降级: MCP 连接失败不影响内置工具，仅 log 记录 - 启动加载: 先连接环境变量配置，再连接数据库配置 - 运行时管理: 支持不重启服务即可增删改 MCP Server Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-06 18:29:02 -08:00

Author

SHA1

Message

Date

hailin

714a674818

feat(mcp): add MCP Server management — backend API + admin UI

实现完整的 MCP (Model Context Protocol) 服务器管理功能，包括后端 API 和管理界面。

## 后端 (conversation-service)

### MCP 混合架构核心 (新增)
- mcp.types.ts: MCP 类型定义 (McpServerConfig, McpToolDefinition, McpConnectionState 等)
- mcp-config.service.ts: 配置解析 — 支持环境变量 MCP_SERVERS 和租户级配置
- mcp-client.service.ts: MCP 客户端 — 连接管理、工具发现、工具执行、运行时增删改
- mcp.module.ts: @Global NestJS 模块，注册 MCP 服务 + TypeORM 实体 + Repository

### 数据持久化 (新增)
- 20260206_add_mcp_server_configs.sql: 数据库迁移 — mcp_server_configs 表
- mcp-server-config.orm.ts: TypeORM 实体 (tenant_id 支持多租户)
- mcp-server-config.repository.ts: Repository 层 (CRUD + ORM→McpServerConfig 转换)

### Admin API (新增)
- admin-mcp.controller.ts: 11 个管理端点，路由前缀 conversations/admin/mcp
  - GET /overview — 统计信息 (服务器总数、已连接、错误、工具总数)
  - GET/POST /servers — 列表 + 创建
  - GET/PUT/DELETE /servers/:id — 详情 + 更新 + 删除
  - POST /servers/:id/connect — 手动连接
  - POST /servers/:id/disconnect — 手动断开
  - GET /servers/:id/tools — 查看已发现工具
  - POST /servers/:id/test — 测试连接
  - POST /test-config — 测试未保存的配置

### 已有文件修改
- coordinator-tools.ts: getToolsForClaudeAPI() 支持 additionalTools 可选参数
- agent-loop.ts: 支持 additionalTools + additionalConcurrencyMap 透传
- coordinator-agent.service.ts: 注入 McpClientService，工具路由加 MCP 分支
- agents.module.ts: 导入 McpModule
- conversation.module.ts: 注册 AdminMcpController

## 前端 (admin-client)

### API + Hooks (新增)
- mcp.api.ts: Axios API 客户端 + 完整 TypeScript 类型定义
- useMcp.ts: 10 个 React Query hooks (queries + mutations)

### UI 页面 (新增)
- McpPage.tsx: 主页面 — 统计卡片 + 服务器表格 + 操作按钮
- ServerFormDrawer.tsx: 创建/编辑表单 — 基本信息、传输配置、高级设置、连接测试
- ServerDetailDrawer.tsx: 详情抽屉 — 配置展示、工具浏览 (Collapse + JSON Schema)

### 路由 + 导航
- App.tsx: 添加 /mcp 路由
- MainLayout.tsx: 侧边栏添加 "MCP 服务器" 菜单项 (ApiOutlined 图标)

## 依赖
- @modelcontextprotocol/sdk: ^1.0.0 (MCP 协议 SDK)

## 架构设计
- 混合架构: 16 个内置工具保持不变 + MCP 工具动态发现/热插拔
- 工具名前缀 mcp__{serverId}__{toolName} 确保零冲突
- 优雅降级: MCP 连接失败不影响内置工具，仅 log 记录
- 启动加载: 先连接环境变量配置，再连接数据库配置
- 运行时管理: 支持不重启服务即可增删改 MCP Server

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-06 18:29:02 -08:00

1 Commits