57 lines
1.8 KiB
Markdown
57 lines
1.8 KiB
Markdown
# WC-SPC AI MCP Service
|
||
|
||
本服务为 `MES-Manager_View` 提供本地 MCP 工具和 DeepSeekV4Pro 网页助手代理。
|
||
|
||
## 启动
|
||
|
||
```powershell
|
||
npm run kb:build
|
||
npm run ai:mcp
|
||
```
|
||
|
||
或日常启动：
|
||
|
||
```powershell
|
||
npm run start:daily
|
||
```
|
||
|
||
## 配置
|
||
|
||
可创建本地文件 `mcp-server/.env.local`，不要提交到 Git：
|
||
|
||
```text
|
||
AI_MCP_PORT=3100
|
||
DEEPSEEK_API_KEY=your_deepseek_key
|
||
DEEPSEEK_MODEL=deepseek-v4-pro
|
||
DEEPSEEK_BASE_URL=https://api.deepseek.com
|
||
MES_BACKEND_URL=http://127.0.0.1:10050/submit/MESCommonBase.ashx
|
||
SPC_BACKEND_URL=http://localhost:57966
|
||
AI_MCP_ALLOW_BACKEND_CALLS=false
|
||
```
|
||
|
||
未配置 `DEEPSEEK_API_KEY` 时，助手仍可基于本地知识库回答项目功能、质量模块和 SPC 页面映射问题。
|
||
|
||
数据查询约束：AI 助手不直连 SQL Server，不依赖数据库账号。所有数据查询必须复用项目人机界面已有能力，例如 Vue 页面中的 `CreateData` 参数、`MESCommonBase.ashx` 查询入口、已有 `src/api` 函数和 SPC 专用接口。
|
||
|
||
## 端点
|
||
|
||
- `GET /health`
|
||
- `GET /api/tools`
|
||
- `POST /mcp`
|
||
- `POST /api/assistant/chat`
|
||
|
||
## 工具
|
||
|
||
- `project_summary`
|
||
- `search_project_functions`
|
||
- `list_quality_modules`
|
||
- `search_quality_functions`
|
||
- `describe_quality_data_query`
|
||
- `query_quality_data`：复用 `/QualityAssurance/AssemblyQualitydataQuery` 页面 `selectDate()` 的 `CreateData('11', '质量数据_发动机质量数据_各个工位_视图_发动机型号_综合查询', param)` 参数结构；有条件按条件查，无条件按全时间范围、无筛选条件返回最新 200 条。
|
||
- `list_spc_charts`
|
||
- `spc_query_chart`
|
||
- `reload_project_index`
|
||
- `call_mes_backend`
|
||
|
||
`call_mes_backend` 默认禁用，避免 AI 直接执行会修改业务数据的后端操作。查询类能力应优先使用已解析出的页面查询画像和项目已有查询入口。
|