m8-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,67 @@
+# M8 移动端框架智能辅助工具 (MCP)
+
+本工具是一个 Model Context Protocol (MCP) 服务，专为 Epoint M8 移动前端框架开发者设计。它允许 AI 助手直接查询 M8 UI 组件、Util 工具类、EJS 原生 API 文档，并获取内置的编码规范，从而生成符合标准的高质量代码。
+
+## 功能特性
+
+- **文档查询**: 快速检索 M8 UI 组件 (如 `uploader`, `datepicker`) 和常用工具方法。
+- **EJS API**: 查询 EJS 容器提供的原生能力 (如 `audio`, `camera`)。
+- **规范检索**: 获取项目内置的 JS, Vue, CSS 编码规范。
+
+## 安装
+
+无需克隆源码，支持直接通过 `npx` 使用（需先发布到 npm）：
+
+```bash
+npx m8-mcp-server
+```
+
+或者全局安装：
+
+```bash
+npm install -g m8-mcp-server
+m8-mcp
+```
+
+## 配置 (Claude Desktop)
+
+在您的 `claude_desktop_config.json` 中添加以下配置：
+
+```json
+{
+  "mcpServers": {
+    "m8-mcp": {
+      "command": "npx",
+      "args": ["-y", "m8-mcp-server"]
+    }
+  }
+}
+```
+
+## 💡 AI 提示词规范 (Prompt)
+
+为了让 AI 更好地利用此工具，请在对话开头使用以下提示词：
+
+```text
+你是一位精通 Epoint M8 移动端框架的开发专家。请利用 m8-mcp 工具辅助我也完成开发任务。
+
+开发原则：
+1. **优先查阅文档**：在编写任何 UI 组件或调用原生 API 之前，必须先使用 `search_m8_docs` 或 `search_ejs_api` 查询相关文档，确保参数和用法正确。
+2. **遵守编码规范**：生成代码前，请检查或回忆 `get_coding_standards` 中的规范，特别是文件头注释、CSS 命名隔离等要求。
+3. **智能推荐**：如果我不确定使用哪个组件，请根据我的需求描述查询文档并推荐最合适的组件。
+```
+
+## 使用示例
+
+- **查找上传组件**: 调用 `search_m8_docs("uploader")`
+- **查找音频 API**: 调用 `search_ejs_api("audio")`
+- **查看 JS 规范**: 调用 `get_coding_standards("js")`
+
+## 发布与构建
+
+本项目的源码不包含在 npm 包中，仅包含编译后的 `dist` 目录。
+
+```bash
+# 本地构建 (生成 dist 并混淆)
+npm run build
+```

package/bin/m8-mcp.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/index.js');

package/dist/constants.js

@@ -0,0 +1 @@
+const a0_0x4db045=a0_0x33ed;(function(_0x57558c,_0x5ac6a1){const _0x495b27=a0_0x33ed,_0x49eb16=_0x57558c();while(!![]){try{const _0x1de8c1=-parseInt(_0x495b27(0x1c4))/0x1+parseInt(_0x495b27(0x1b9))/0x2*(-parseInt(_0x495b27(0x1cc))/0x3)+-parseInt(_0x495b27(0x1c0))/0x4*(parseInt(_0x495b27(0x1c9))/0x5)+parseInt(_0x495b27(0x1b7))/0x6+-parseInt(_0x495b27(0x1c5))/0x7+-parseInt(_0x495b27(0x1d0))/0x8+parseInt(_0x495b27(0x1c1))/0x9;if(_0x1de8c1===_0x5ac6a1)break;else _0x49eb16['push'](_0x49eb16['shift']());}catch(_0x22f907){_0x49eb16['push'](_0x49eb16['shift']());}}}(a0_0x2dc6,0x5d4f8));const a0_0x41522a=(function(){let _0x493f54=!![];return function(_0x2da0b3,_0x1ec6b9){const _0x3baa30=_0x493f54?function(){if(_0x1ec6b9){const _0x4704be=_0x1ec6b9['apply'](_0x2da0b3,arguments);return _0x1ec6b9=null,_0x4704be;}}:function(){};return _0x493f54=![],_0x3baa30;};}()),a0_0x3e463f=a0_0x41522a(this,function(){const _0x58149a=a0_0x33ed;return a0_0x3e463f['toString']()[_0x58149a(0x1bf)](_0x58149a(0x1d6))[_0x58149a(0x1c3)]()[_0x58149a(0x1ce)](a0_0x3e463f)[_0x58149a(0x1bf)](_0x58149a(0x1d6));});function a0_0x2dc6(){const _0x1cffff=['2708360Iqrwoe','__esModule','data','standards','defineProperty','__importDefault','(((.+)+)+)+$','DATA_DIR','4437930PphuVN','STANDARDS_DIR','638882yFPNwr','getDataDir','m8mpdoc-develop','src/data','default','PROJECT_ROOT','search','107996YbyRrV','6664860LevGdZ','resolve','toString','151828htOxLA','505323XSvZct','extname','.ts','M8_DOCS_DIR','40olYobA','join','EJS_DOCS_DIR','3nxKjXS','../src/data','constructor','PROD_DOCS_DIR'];a0_0x2dc6=function(){return _0x1cffff;};return a0_0x2dc6();}function a0_0x33ed(_0x17e400,_0x42e155){_0x17e400=_0x17e400-0x1b6;const _0x345b33=a0_0x2dc6();let _0x3e463f=_0x345b33[_0x17e400];return _0x3e463f;}a0_0x3e463f();'use strict';var __importDefault=this&&this[a0_0x4db045(0x1d5)]||function(_0x1578df){const _0x10c994=a0_0x4db045;return _0x1578df&&_0x1578df[_0x10c994(0x1d1)]?_0x1578df:{'default':_0x1578df};};Object[a0_0x4db045(0x1d4)](exports,a0_0x4db045(0x1d1),{'value':!![]}),exports['STANDARDS_DIR']=exports[a0_0x4db045(0x1cb)]=exports['M8_DOCS_DIR']=exports[a0_0x4db045(0x1cf)]=exports['DOCS_DIR']=exports[a0_0x4db045(0x1be)]=exports[a0_0x4db045(0x1b6)]=void 0x0,exports[a0_0x4db045(0x1ba)]=getDataDir;const path_1=__importDefault(require('path'));exports[a0_0x4db045(0x1b6)]=path_1['default'][a0_0x4db045(0x1ca)](__dirname,a0_0x4db045(0x1cd));const IS_TS_NODE=path_1[a0_0x4db045(0x1bd)][a0_0x4db045(0x1c6)](__filename)===a0_0x4db045(0x1c7);exports['PROJECT_ROOT']=path_1[a0_0x4db045(0x1bd)][a0_0x4db045(0x1c2)](__dirname,IS_TS_NODE?'..':'..'),exports['DOCS_DIR']=path_1[a0_0x4db045(0x1bd)]['join'](exports['PROJECT_ROOT'],a0_0x4db045(0x1bc)),exports[a0_0x4db045(0x1cf)]=path_1['default'][a0_0x4db045(0x1ca)](exports[a0_0x4db045(0x1be)],a0_0x4db045(0x1d2));function getDataDir(){const _0x31528e=a0_0x4db045;return path_1[_0x31528e(0x1bd)][_0x31528e(0x1ca)](__dirname,_0x31528e(0x1d2));}exports[a0_0x4db045(0x1c8)]=a0_0x4db045(0x1bb),exports[a0_0x4db045(0x1cb)]='ejs-doc',exports[a0_0x4db045(0x1b8)]=a0_0x4db045(0x1d3);

package/dist/data/ejs-doc/api_audio/api_audio.md

@@ -0,0 +1,225 @@
+# ejs.audio
+
+## startRecord
+
+开始录制音频
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持（3.1.2） |   支持（3.1.2）   | 不支持 | 不支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.audio.startRecord({
+    minDuration: 1,
+    maxDuration: 120,
+    folderPath: '',
+    fileName: '',
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+**参数说明**
+
+| 参数        |    参数类型     | 说明                                                            | 平台差异说明                                |
+| :---------- | :-------------: | :-------------------------------------------------------------- | :------------------------------------------ |
+| minDuration | Number / String | 最小允许可录制时长，默认为`1`，单位秒                           | EJS`3.4.0`开始支持，其他平台不支持          |
+| maxDuration | Number / String | 最大允许可录制时长，默认为`120`，单位秒，EJS-iOS 不支持默认时长 |                                             |
+| folderPath  |     String      | 音频根目录，不传递则有默认的音频存储根目                        | 仅 EJS`3.4.0`开始支持，EJS-iOS 不支持该参数 |
+| fileName    |     String      | 音频文件名， 不传递则使用默认的音频文件                         | 仅 EJS`3.4.0`开始支持，EJS-iOS 不支持该参数 |
+
+## stopRecord
+
+停止录制音频，并返回结果
+
+请在`maxDuration`之前停止
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持（3.1.2） |   支持（3.1.2）   | 不支持 | 不支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.audio.stopRecord({
+    success: function (result) {
+        /**
+         * 选择文件后返回
+         * {
+                duration: 3,
+                path: '/storage/emulated/0/com.epoint.workplatform/kfld/Temp/1513243453523.amr',
+           }
+         */
+    },
+    error: function (error) {}
+});
+```
+
+**返回说明**
+
+| 参数     | 参数类型 | 说明               | 平台差异说明 |
+| :------- | :------: | :----------------- | :----------- |
+| duration |  String  | 录音的时长，单位 s |              |
+| path     |  String  | 录音的完整本地路径 |              |
+
+## pauseRecord
+
+暂停录音
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 不支持        |      不支持       | 不支持 | 不支持 | 支持       | 不支持       |
+
+**使用示例**
+
+```js
+ejs.audio.pauseRecord({
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+## resumeRecord
+
+继续录音
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 不支持        |      不支持       | 不支持 | 不支持 | 支持       | 不支持       |
+
+**使用示例**
+
+```js
+ejs.audio.resumeRecord({
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+## cancelRecord
+
+取消正在进行的音频录制
+
+取消后会销毁文件
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持（3.1.2） |   支持（3.1.2）   | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.audio.cancelRecord({
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+## startPlay
+
+播放音频文件
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持（3.1.2） |   支持（3.1.2）   | 不支持 | 不支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.audio.startPlay({
+    path: '/storage/emulated/0/com.epoint.workplatform/kfld/Temp/1513243453523.amr',
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+**参数说明**
+
+| 参数 | 参数类型 | 说明                       |
+| :--- | :------: | :------------------------- |
+| path |  String  | `必填`，需要播放的文件路径 |
+
+## stopPlay
+
+停止播放音频文件
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持（3.1.2） |   支持（3.1.2）   | 不支持 | 不支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.audio.stopPlay({
+    // path: '/storage/emulated/0/com.epoint.workplatform/kfld/Temp/1513243453523.amr',
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+**参数说明**
+
+| 参数 | 参数类型 | 说明                   | 平台差异说明                                |
+| :--- | :------: | :--------------------- | :------------------------------------------ |
+| path |  String  | 需要停止播放的文件路径 | EJS `3.4.0`后不需要填写，其他平台不需要填写 |
+
+## pausePlay
+
+暂停播放音频文件
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 不支持        |      不支持       | 不支持 | 不支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.audio.pausePlay({
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+## seek
+
+跳转音频至第几秒
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 不支持        |      不支持       | 不支持 | 不支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.audio.seek({
+    position: 2,
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+**参数说明**
+
+| 参数     |    参数类型     | 说明                       | 平台差异说明 |
+| :------- | :-------------: | :------------------------- | :----------- |
+| position | Number / String | 跳转到音频某个位置，单位秒 |              |

package/dist/data/ejs-doc/api_auth/api_auth.md

@@ -0,0 +1,256 @@
+# ejs.auth
+
+## getToken
+
+获取`token`，标准接口需要`token`才能正常请求
+
+如果是使用的公司开发框架，`ajax`请求中自动带了`token`，无需关心
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持          |       支持        | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.auth.getToken({
+    success: function (result) {
+        /**
+         * {
+                access_token: ''
+           }
+         */
+    },
+    error: function (error) {}
+});
+```
+
+**返回说明**
+
+| 参数         | 参数类型 | 说明                                                                   |
+| :----------- | :------: | :--------------------------------------------------------------------- |
+| access_token |  String  | 对应的`token`，必须登录后才会有，`token`的刷新由原始容器进行，无需关心 |
+
+## refreshToken
+
+刷新`token`API
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持          |       支持        | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.auth.refreshToken({
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+**参数说明**
+
+| 参数         |    参数类型     | 说明                                                                                                                          |
+| :----------- | :-------------: | :---------------------------------------------------------------------------------------------------------------------------- |
+| isForce      | Number / String | 是否强制刷新 token，默认超出 expires_in 过期时间后才会刷新，如果要强制刷新传 1。iOS（ejs > `3.4.0`） 支持；`Android` 默认支持 |
+| isAutoLogout | Number / String | refreshToken 过期后是否自动退出登录，默认会自动退出，如果不自动退出则传 0。iOS（ejs > `3.4.0`） 支持；`Android` 默认支持      |
+
+## getUserInfo
+
+获取当前登陆用户信息
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持          |       支持        | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.auth.getUserInfo({
+    success: function (result) {
+        /**
+         * {
+            userInfo: '{...}'
+           }
+         */
+    },
+    error: function (error) {}
+});
+```
+
+**返回说明**
+
+`userInfo` 是一个 JSON 格式的字符串，包含当前登录用户的信息。以下是 JSON.parse()解析 `userInfo` 后所得到的用户信息对象的属性说明：
+
+| 参数             | 参数类型 | 说明                   |
+| :--------------- | :------: | :--------------------- |
+| displayname      |  String  | 用户姓名               |
+| ouguid           |  String  | 部门标识               |
+| baseouname       |  String  | 独立部门名称           |
+| baseouguid       |  String  | 独立部门标识           |
+| ccworksequenceid |  String  | 新版即时通讯账号       |
+| loginid          |  String  | 登录名                 |
+| forcemodifypwd   |  String  | 是否需要强制修改密码   |
+| oaversion        |  String  | 返回业务系统的 oa 版本 |
+| userguid         |  String  | 用户标识               |
+| previewurl       |  String  | 文件在线预览地址       |
+| complexpassword  |  String  | 密码复杂度规则         |
+| usersignpicture  |  String  | 用户签名图片地址       |
+| photourl         |  String  | 用户个人头像地址       |
+| ouname           |  String  | 部门名称               |
+| sequenceid       |  String  | 用户微消息帐号         |
+
+## refreshUserInfo
+
+更新原生本地的用户信息，并返回新的用户信息
+
+**平台差异**
+
+| ejs（H5 应用)   | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :-------------- | :---------------: | :----: | :----- | :--------- | :----------- |
+| `>= 4.2.3 `支持 | `>= V2.0.2` 支持  | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.auth.refreshUserInfo({
+    success: function (result) {
+        /**
+         * {
+            userInfo: {
+                ...
+            }
+           }
+         */
+    },
+    error: function (error) {}
+});
+```
+
+**返回说明**
+
+| 参数     | 参数类型 | 说明                   |
+| :------- | :------: | :--------------------- |
+| userInfo |  Object  | 对应的当前登录用户信息 |
+
+## getAuthCode
+
+获取用户授权码(只有在需要鉴权的项目中需要用到)
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持          |       支持        | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.auth.getAuthCode({
+    success: function (result) {
+        /**
+         * {
+            authCode: ''
+           }
+         */
+    },
+    error: function (error) {}
+});
+```
+
+**返回说明**
+
+| 参数     | 参数类型 | 说明       |
+| :------- | :------: | :--------- |
+| authCode |  String  | 用户授权码 |
+
+## getUserAuthCode
+
+调用框架接口获取 `authcode`，H5 应用下需要鉴权后使用
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持          |       支持        | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.auth.getUserAuthCode({
+    appkey: '应用的appkey',
+    success: function (result) {
+        /**
+         * {
+            authcode: ''
+           }
+         */
+    },
+    error: function (error) {}
+});
+```
+
+**参数说明**
+
+| 参数   | 参数类型 | 说明           |
+| :----- | :------: | :------------- |
+| appkey |  String  | 应用的`appkey` |
+
+**返回说明**
+
+| 参数     | 参数类型 | 说明       |
+| :------- | :------: | :--------- |
+| authcode |  String  | 用户授权码 |
+
+## logoutUserWithAlert
+
+退出当前用户至登录页面
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持（3.5.0） |    支持(3.5.0)    | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.auth.logoutUserWithAlert({
+    title: '提示',
+    message: '请重新登录',
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+**参数说明**
+
+| 参数    | 参数类型 | 说明     |
+| :------ | :------: | :------- |
+| title   |  String  | 提示标题 |
+| message |  String  | 提示内容 |
+
+## logout
+
+退出当前用户至登录页面，无 UI 提示
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持（4.1.9） |    支持(4.1.9)    | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.auth.logout({
+    success: function (result) {},
+    error: function (error) {}
+});
+```