# 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 直接执行会修改业务数据的后端操作。查询类能力应优先使用已解析出的页面查询画像和项目已有查询入口。