glass-mcp

一个用于配眼镜咨询场景的 MCP Server，提供验光单解读、镜片推荐、镜框选择、视力检查建议，以及新眼镜不适排查等能力。

这个项目目前提供两种运行方式：

stdio MCP Server：用于 Claude Desktop 或其他支持 MCP 的客户端
本地 Web 调试页：用于浏览器里直接填写参数、查看工具返回结果

功能

当前内置工具：

vision_check_guide：按年龄段提供视力检查建议
lens_recommendation：根据度数、用途、预算推荐镜片
frame_selection_guide：根据脸型、生活方式和度数推荐镜框
prescription_interpreter：解读验光单参数
progressive_lens_assessment：评估是否适合渐进镜片或办公镜
new_glasses_troubleshooting：排查新眼镜佩戴不适

环境要求

Node.js 18+
npm

安装

cd /Users/kang/develop/project/glass-mcp
npm install

常用命令

npm run build
npm test
npm start
npm run web

说明：

npm run build：编译 TypeScript 到 dist/
npm test：编译并运行测试
npm start：启动 stdio MCP Server
npm run web：启动本地网页调试页

作为 MCP Server 使用

先编译：

npm run build

然后直接启动：

node dist/index.js

如果要接到 Claude Desktop 或其他 MCP 客户端，可以使用类似配置：

{
  "mcpServers": {
    "glass-mcp": {
      "command": "node",
      "args": ["/Users/kang/develop/project/glass-mcp/dist/index.js"]
    }
  }
}

本地网页调试

启动：

npm run web

浏览器打开：

http://127.0.0.1:3000

页面用途：

直接查看全部工具
通过表单或 JSON 输入参数
执行工具并查看文本结果
用于本地演示，不依赖 MCP 客户端

注意：这个页面只是调试入口，不替代真正的 MCP stdio 接入方式。

项目结构

src/
  index.ts       MCP Server 主入口与工具实现
  web.ts         本地网页调试服务
  index.test.ts  基础测试
dist/            编译产物

验证项目是否正常

推荐按下面顺序验证：

运行测试

npm test

验证 MCP 入口能启动

node dist/index.js

正常情况进程会保持运行并等待客户端连接。

验证本地页面

npm run web

然后打开 http://127.0.0.1:3000。

当前实现说明

工具返回的是文本型 MCP 结果
页面展示层已经做了中文化处理
页面中的中文下拉框选项会映射回原始英文枚举值再调用后端
目前重点是本地调试和 MCP 工具调用，不是完整线上产品

后续可扩展方向

增加更多配镜业务规则和案例库
增加工具调用历史记录
增加示例数据一键填充
增加更正式的前端产品页面
增加更多自动化测试

MCP Servers