@ty_krystal/sei-ai 0.1.4 → 0.1.6

package/package.json

@@ -1,57 +1,78 @@
 {
   "name": "@ty_krystal/sei-ai",
-  "version": "0.1.4",
-  "description": "SEI MCP server and developer CLI for query, save, query-sql, and api-docs workflows",
-  "keywords": [
-    "sei",
-    "mcp",
-    "cli",
-    "openapi"
+  "description": "SEI CLI generated with oclif",
+  "version": "0.1.6",
+  "author": "tanyu",
+  "bin": {
+    "sei-ai": "./bin/run.js"
+  },
+  "bugs": "https://github.com/tanyu/sei-ai/issues",
+  "dependencies": {
+    "@oclif/core": "^4",
+    "@oclif/plugin-help": "^6",
+    "@oclif/plugin-plugins": "^5",
+    "@ty_krystal/sei-ai-core": "workspace:*"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1",
+    "@oclif/prettier-config": "^0.2.1",
+    "@oclif/test": "^4",
+    "@types/chai": "^4",
+    "@types/mocha": "^10",
+    "@types/node": "^18",
+    "chai": "^4",
+    "eslint": "^9",
+    "eslint-config-oclif": "^6",
+    "eslint-config-prettier": "^10",
+    "mocha": "^11",
+    "oclif": "^4",
+    "shx": "^0.3.4",
+    "ts-node": "^10",
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "./bin",
+    "./dist",
+    "./oclif.manifest.json"
   ],
   "homepage": "https://github.com/tanyu/sei-ai",
-  "bugs": {
-    "url": "https://github.com/tanyu/sei-ai/issues"
+  "keywords": ["oclif", "sei", "cli"],
+  "license": "MIT",
+  "main": "dist/index.js",
+  "type": "module",
+  "oclif": {
+    "bin": "sei-ai",
+    "dirname": "sei-ai",
+    "commands": "./dist/commands",
+    "plugins": [
+      "@oclif/plugin-help",
+      "@oclif/plugin-plugins"
+    ],
+    "topicSeparator": ":"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/tanyu/sei-ai.git"
   },
-  "license": "MIT",
-  "type": "module",
-  "files": [
-    "dist",
-    "README.md",
-    "config.example.json"
-  ],
-  "bin": {
-    "sei-ai": "dist/index.js"
-  },
-  "main": "./dist/index.js",
-  "exports": {
-    ".": {
-      "default": "./dist/index.js"
-    }
-  },
   "scripts": {
-    "dev": "tsx src/index.ts",
-    "start": "node dist/index.js",
-    "start:stdio": "node dist/index.js stdio --config ./config.example.json",
-    "start:http": "node dist/index.js streamable-http --host 0.0.0.0 --port 3000 --path /mcp --config ./config.example.json",
-    "build": "pnpm vite build",
-    "test": "node --import tsx --test test/**/*.test.ts",
-    "check": "pnpm run typecheck && pnpm run test",
+    "build": "pnpm --filter @ty_krystal/sei-ai-core build && shx rm -rf dist && tsc -b",
+    "dev": "node ./bin/dev.js",
+    "lint": "eslint",
+    "postpack": "shx rm -f oclif.manifest.json",
+    "posttest": "pnpm run lint",
+    "prepack": "oclif manifest && oclif readme",
+    "prepublishOnly": "pnpm run build",
+    "publish:npm": "npm publish --access public",
+    "start": "node ./bin/run.js",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "prepublishOnly": "pnpm run build"
+    "test": "pnpm --filter @ty_krystal/sei-ai-core typecheck && mocha --forbid-only \"test/**/*.test.ts\"",
+    "version": "oclif readme && git add README.md"
   },
-  "engines": {
-    "node": "^22.18.0 || ^24.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "tsx": "^4.22.4",
-    "zod": "^3.25.76"
-  }
+  "types": "dist/index.d.ts"
 }

package/config.example.json

@@ -1,33 +0,0 @@
-{
-  "baseUrl": "http://127.0.0.1:8081",
-  "auth": {
-    "mode": "ai-login",
-    "aiKeyEnv": "SEI_AI_LOGIN_KEY",
-    "roleEnv": "SEI_AI_LOGIN_ROLE"
-  },
-  "tools": {
-    "query": true,
-    "save": true,
-    "schema": true,
-    "querySql": false
-  },
-  "targets": {
-    "modules": {
-      "demo_order": {
-        "mainTable": "demo_order",
-        "query": {
-          "fields": ["_ID", "ORDER_NO", "STATUS", "AMOUNT"],
-          "defaultFields": ["_ID", "ORDER_NO", "STATUS"],
-          "allowAllFields": false
-        },
-        "save": {
-          "actions": ["add", "edit"],
-          "fields": ["STATUS", "MEMO"]
-        }
-      }
-    },
-    "tables": {},
-    "sources": {},
-    "views": {}
-  }
-}

package/dist/README.md

@@ -1,232 +0,0 @@
-# sei-ai
-
-独立的 SEI MCP 服务，使用 `@modelcontextprotocol/sdk` 运行。
-支持 `stdio`、`streamable-http` 和开发者 CLI 启动，默认只开放受控的低代码查询、保存和字段元数据工具，`querySql` 默认关闭。
-构建改为使用 Vite 进行 Node 侧打包，产物输出到 `dist/`。
-
-## 安装
-
-```bash
-npm install -g sei-ai
-```
-
-## 命令
-
-```bash
-pnpm -F sei-ai-mcp dev -- --config ./apps/sei-ai-mcp/config.example.json
-pnpm -F sei-ai-mcp run start:stdio
-pnpm -F sei-ai-mcp run start:http
-pnpm -F sei-ai-mcp run build
-pnpm -F sei-ai-mcp run test
-```
-
-打包后 CLI：
-
-```bash
-sei-ai help
-sei-ai stdio --config ./config.example.json
-sei-ai streamable-http --host 0.0.0.0 --port 3000 --path /mcp --config ./config.example.json
-sei-ai cli api-docs --format markdown
-sei-ai cli query-sql "SELECT _UID,_NAME FROM _SYS_USER"
-sei-ai cli call POST /api/sei/data/removeAllCache --json '{}'
-```
-
-## 开发者 CLI
-
-CLI 是新增的开发者命令面，不会改变现有 MCP server 的启动方式、tool 列表或 Host 集成配置。
-
-首版支持：
-
-- `call`
-- `query`
-- `save`
-- `query-sql`
-- `api-docs`
-
-命令示例：
-
-```bash
-sei-ai cli query --json '{"head":{"module":"sys_user"},"option":{"fields":"_UID,_NAME"}}'
-sei-ai cli save --json '{"head":{"module":"sys_user"},"data":[{"action":"edit","rows":[{"keyVal":"admin","row":{"_NAME":"管理员"}}]}]}'
-sei-ai cli query-sql "SELECT _UID,_NAME FROM _SYS_USER" --page 1 --size 20
-sei-ai cli api-docs --keyword login --format json
-```
-
-常用认证参数：
-
-- `--base-url`
-- `--ai-key`
-- `--role`
-- `--account`
-- `--account-project`
-- `--account-checkcode`
-- `--token`
-- `--timeout`
-
-环境变量加载规则：
-
-- 启动时会自动读取当前工作目录下的 `.env.local` 和 `.env`
-- 加载顺序为 `.env.local` 再 `.env`
-- 已经存在的进程环境变量不会被 `.env` 覆盖
-- 显式 CLI 参数仍然优先于环境变量
-
-载荷输入支持：
-
-- `--json '<payload>'`
-- `--file ./payload.json`
-- `--stdin`
-
-当前仍未覆盖：
-
-- `init-base-data`
-- 字典相关命令
-- DDL/DML
-- 文件上传下载
-
-HTTP 模式：
-
-```bash
-pnpm -F sei-ai-mcp dev -- --transport streamable-http --host 0.0.0.0 --port 3000 --path /mcp --config ./apps/sei-ai-mcp/config.example.json
-```
-
-Docker Compose：
-
-```bash
-docker compose -f apps/sei-ai-mcp/docker-compose.yml up -d --build
-```
-
-容器默认暴露 `http://127.0.0.1:3719/mcp`，并通过 `host.docker.internal` 访问宿主机上的 SEI 后端。
-如果后端也在 compose 中运行，把 `SEI_BASE_URL` 改成对应服务名即可。
-
-## 配置
-
-支持的配置项：
-
-- `baseUrl`
-- `auth.mode`: `ai-login` 或 `token`
-- `auth.token`
-- `auth.aiKey`
-- `auth.account`
-- `auth.role`
-- `tools.query`
-- `tools.save`
-- `tools.schema`
-- `tools.querySql`
-- `targets.modules`
-- `targets.tables`
-- `targets.sources`
-- `targets.views`
-
-敏感值可通过环境变量注入：
-
-- `SEI_BASE_URL`
-- `SEI_AI_LOGIN_KEY`
-- `SEI_AI_LOGIN_ACCOUNT`
-- `SEI_AI_LOGIN_ROLE`
-- `SEI_TOKEN`
-- `SEI_MCP_TRANSPORT`
-- `SEI_MCP_HOST`
-- `SEI_MCP_PORT`
-- `SEI_MCP_PATH`
-- `SEI_MCP_HTTP_JSON_RESPONSE`
-
-例如可以在项目目录写：
-
-```bash
-SEI_BASE_URL=http://127.0.0.1:8081
-SEI_AI_LOGIN_KEY=dev-ai-secret
-SEI_AI_LOGIN_ROLE=admin
-```
-
-## 权限模型
-
-- 未配置目标时默认拒绝。
-- 查询字段必须命中白名单。
-- 保存字段必须命中白名单。
-- `querySql` 默认关闭，只允许单条 `SELECT/WITH`。
-- stdio 日志只写 `stderr`，不污染 MCP 协议输出。
-
-注意：
-
-- 上面的权限模型只约束 MCP tool 面。
-- 开发者 CLI 直接调用 SEI HTTP 接口，不走 MCP 白名单过滤，因此它是调试/开发入口，不是给模型暴露的 tool 面。
-
-## 工具
-
-- `sei_query`
-- `sei_save`
-- `sei_schema`
-- `sei_query_sql`（默认关闭）
-
-## MCP Host
-
-可直接作为 stdio MCP server 启动，再由上层 Host 注册。
-
-stdio Host 配置示例：
-
-```json
-{
-  "mcpServers": {
-    "sei-ai-mcp": {
-      "command": "sei-ai",
-      "args": [
-        "stdio",
-        "--config",
-        "/abs/path/config.dev.json"
-      ]
-    }
-  }
-}
-```
-
-HTTP 模式可直接挂载到容器端口，Host 地址示例：
-
-```json
-{
-  "mcpServers": {
-    "sei-ai-mcp": {
-      "url": "http://127.0.0.1:3719/mcp"
-    }
-  }
-}
-```
-
-## Spring AI Java 接入
-
-如果 `apps/backend` 通过 Spring AI MCP client 接入，直接使用 `streamable-http`：
-
-```yaml
-spring:
-  ai:
-    mcp:
-      client:
-        enabled: true
-        type: SYNC
-        request-timeout: 30s
-        toolcallback:
-          enabled: true
-        streamable-http:
-          connections:
-            sei-ai-mcp:
-              url: http://127.0.0.1:3719
-              endpoint: /mcp
-```
-
-如果后端默认直接访问宿主机暴露端口，可这样配置：
-
-```bash
-SEI_AI_MCP_HTTP_URL=http://127.0.0.1:3719
-SEI_AI_MCP_HTTP_ENDPOINT=/mcp
-```
-
-如果是宿主机或外部服务直连容器暴露端口，则访问地址为：
-
-```bash
-http://127.0.0.1:3719/mcp
-```
-
-
-
-npm version patch --no-git-tag-version
-pnpm run build
-npm publish --access public --cache /tmp/sei-ai-npm-cache

package/dist/config.example.json

@@ -1,33 +0,0 @@
-{
-  "baseUrl": "http://127.0.0.1:8081",
-  "auth": {
-    "mode": "ai-login",
-    "aiKeyEnv": "SEI_AI_LOGIN_KEY",
-    "roleEnv": "SEI_AI_LOGIN_ROLE"
-  },
-  "tools": {
-    "query": true,
-    "save": true,
-    "schema": true,
-    "querySql": false
-  },
-  "targets": {
-    "modules": {
-      "demo_order": {
-        "mainTable": "demo_order",
-        "query": {
-          "fields": ["_ID", "ORDER_NO", "STATUS", "AMOUNT"],
-          "defaultFields": ["_ID", "ORDER_NO", "STATUS"],
-          "allowAllFields": false
-        },
-        "save": {
-          "actions": ["add", "edit"],
-          "fields": ["STATUS", "MEMO"]
-        }
-      }
-    },
-    "tables": {},
-    "sources": {},
-    "views": {}
-  }
-}