端点科技内部管理系统-EMP的 MCP 工具

功能介绍

针对端点科技内部管理系统-EMP的 MCP 工具的服务，实现以下功能：

1. 查询本周工时
2. 填写本周工时
3. 查询自己有工时填写权限的项目，以及每个项目的类型

技术选型

• Node.js
• TypeScript
• MCP (Model Context Protocol)
• Axios HTTP client

配置说明

1. 获取加密密码

由于EMP系统要求密码必须为加密格式，请按以下步骤获取加密后的密码：

1. 登录EMP系统网页版：https://emp-portal.app.terminus.io
2. 打开浏览器开发者工具：按F12或右键选择

2. 配置环境变量

创建.env文件：

EMP_USERNAME=你的手机号
EMP_PASSWORD=加密后的密码（从浏览器中获取）

3. 安装和运行

从npm安装（推荐）

npm install -g mcp-terminus-emp

从源码安装

# 下载源码包后解压
cd mcp-terminus-emp
npm install
npm run build

使用示例

在Cursor中使用

全局安装后配置

1. 在Cursor设置中添加MCP服务器
2. 配置命令：mcp-terminus-emp
3. 设置环境变量：

   {
     "mcpServers": {
       "terminus-emp": {
         "command": "mcp-terminus-emp",
         "env": {
           "EMP_USERNAME": "你的手机号",
           "EMP_PASSWORD": "加密后的密码"
         }
       }
     }
   }

本地开发配置

1. 在Cursor设置中添加MCP服务器
2. 配置命令：node /path/to/mcp-terminus-emp/dist/index.js
3. 设置环境变量（同上）

使用示例

• "查询我本周的工时"
• "填写明天的工时，项目2067007，类型DEVELOPMENT，80%"
• "查询我有权限的项目"
• "查询详细的工时记录"

实现要点

1. 日期格式转换：将自然语言输入（今天、本周、周一等）转换为接口要求的标准日期格式
2. 参数映射：将项目名称映射为项目ID，类型名称映射为类型ID
3. 异常处理：
   • 检查请假情况（如周三请假则无法填写）
   • 检查工时完整性（每天必须达到100%）
   • 处理网络异常和认证失败
4. 自动重试：认证失败时自动重新登录
5. Cookie管理：自动管理登录状态和会话

发布说明

本项目发布到npm registry，但不开放源码。用户只能安装和使用编译后的代码，源码完全保护。

发布流程

1. 运行 ./package.sh 选择发布到npm registry
2. 用户通过 npm install -g mcp-terminus-emp 安装
3. 在Cursor中配置MCP服务器即可使用

详细发布指南请参考 PUBLISH.md