WC-SPC/MES-Manager_View/mcp-server

WC-SPC AI MCP Service

本服务为 MES-Manager_View 提供本地 MCP 工具和 DeepSeekV4Pro 网页助手代理。

启动

npm run kb:build
npm run ai:mcp

或日常启动：

npm run start:daily

配置

可创建本地文件 mcp-server/.env.local，不要提交到 Git：

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