zion-mcp 2.0.0 → 2.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +29 -13
  2. package/dist/server.js +20245 -2653
  3. package/package.json +7 -2
package/README.md CHANGED
@@ -20,7 +20,7 @@ Zion MCP Server 是 [FunctorZ (Zion)](https://functorz.com) 提供的官方 [Mod
20
20
  4. 填写以下信息：
21
21
  - **Name**: Zion MCP
22
22
  - **Type**: command
23
- - **Command**: `npx -y zion-mcp`
23
+ - **Command**: `npx -y zion-mcp@latest`
24
24
  5. 保存并重启 Cursor (如果需要)。
25
25
 
26
26
  ### 在 Claude Desktop 中使用
@@ -32,7 +32,7 @@ Zion MCP Server 是 [FunctorZ (Zion)](https://functorz.com) 提供的官方 [Mod
32
32
  "mcpServers": {
33
33
  "zion": {
34
34
  "command": "npx",
35
- "args": ["-y", "zion-mcp"]
35
+ "args": ["-y", "zion-mcp@latest"]
36
36
  }
37
37
  }
38
38
  }
@@ -40,17 +40,33 @@ Zion MCP Server 是 [FunctorZ (Zion)](https://functorz.com) 提供的官方 [Mod
40
40
 
41
41
  ## 🛠️ 可用工具 (Tools)
42
42
 
43
- 连接成功后，AI 助手将获得以下能力：
44
-
45
- - **Auth**: `login`, `logout`, `whoami`, `reauth`。
46
- - **Projects**: `create_project`, `get_projects`, `search_projects`, `get_project_detail`, `inspect_project_metadata`, `inspect_project_resources`, `rename_project`, `rename_project_app`, `delete_project`, `reset_project`, `set_current_project`, `get_current_project`。
47
- - **Schema / Backend Sync**: `load_project_schema`, `schema_status`, `schema_snapshot`, `sync_project`, `reload_project`, `save_schema`, `validate_schema`, `sync_backend`。Schema 修改命令会返回 ztype 校验诊断，包括后端 type-check 错误。
48
- - **Editing**: `ztype_tool_calls`, `apply_schema_diff`, plus typed CRUD wrappers such as `schema_add_tables`, `schema_add_fields_and_relations`, and `schema_add_object_type_definitions`。
49
- - **Supportservice Data**: `supportservice_query`, `supportservice_insert`, `supportservice_update`, `supportservice_delete`, `supportservice_graphql`。
50
- - **Mock Data**: `create_and_save_mock_data_recursively`。
51
- - **ZB**: `zb_graphql_query`, `zb_graphql_mutation`。
52
- - **`set_current_working_directory`**: 设置当前工作目录（通常自动处理）。
53
- - **`get_project_schema`**: 保留的兼容工具，返回简化 Schema。
43
+ 连接成功后，AI 助手将获得以下工具。部分为 **facade 工具**，通过 `op` 参数选择具体操作：
44
+
45
+ - **Auth**: `auth`（op：`LOGIN` / `LOGOUT` / `WHOAMI` / `REAUTH`）、`get_account_profile`。
46
+ - **Projects**: `get_projects`、`create_project`、`set_current_project`、`get_current_project`、`rename_project`、`rename_project_app`、`delete_project`、`reset_project`、`get_project_schema`（保留的简化 Schema 兼容工具）、`project_inspect`（op：`DETAIL` / `METADATA` / `RESOURCES`）。
47
+ - **Schema 会话**: `schema_session`（op：`LOAD` / `RELOAD` / `SYNC` / `SNAPSHOT` / `SAVE` / `VALIDATE`）、`schema_observe`（op：`STATE` / `EVENTS`）、`schema_status`。修改仅存于内存 CRDT 会话，需 `SAVE` + `sync_backend` 后才会生效上线。
48
+ - **Schema 编辑（ztype facades）** — 每个工具带一个 `op`；传入 `apply: true` 上传 CRDT patch，再执行 `schema_session op=SAVE` + `sync_backend` 部署。由 ztype 工具目录自动生成：
49
+ <!-- GENERATED-ZTYPE-TOOLS:START (pnpm gen:tools) -->
50
+ - `schema_actionflow` — op: `ADD` / `ADD_GLOBAL_VARS` / `ADD_INPUT_PARAMS` / `ADD_OUTPUT_FIELDS` / `CLEAR_OUTPUT` / `DELETE` / `DELETE_GLOBAL_VARS` / `DELETE_INPUT_PARAMS` / `DELETE_OUTPUT_FIELDS` / `GET_DETAIL` / `SELECTABLE_TYPES` / `LIST` / `SET_OUTPUT` / `UPDATE` / `UPDATE_GLOBAL_VARS` / `UPDATE_INPUT_PARAMS`
51
+ - `schema_actionflow_node` — op: `ADD_BRANCH_ITEM` / `ADD_NODE` / `ADD_CODE_INPUT` / `ADD_VAR_TARGETS` / `DELETE_NODES` / `DELETE_CODE_INPUT` / `DELETE_VAR_TARGETS` / `CONTEXT_INFO` / `MOVE_NODE` / `RENAME_CODE_INPUT` / `UPDATE_NODE`
52
+ - `schema_api` — op: `ADD` / `ADD_INPUT_VARIABLES` / `ADD_PARAMETERS` / `ADD_RESPONSE_CONFIGS` / `ADD_WORKSPACES` / `ADD_WORKSPACE_CONSTANTS` / `DELETE` / `DELETE_INPUT_VARIABLES` / `DELETE_PARAMETERS` / `DELETE_RESPONSE_CONFIGS` / `DELETE_WORKSPACES` / `DELETE_WORKSPACE_CONSTANTS` / `LIST` / `LIST_WORKSPACES` / `GET_DETAIL` / `UPDATE` / `UPDATE_INPUT_VARIABLES` / `UPDATE_PARAMETERS` / `UPDATE_RESPONSE_CONFIGS` / `UPDATE_WORKSPACE` / `UPDATE_WORKSPACE_CONSTANTS`
53
+ - `schema_binding_inspect` — op: `BINDING_OPTIONS` / `BINDING_TYPE` / `FORMULA_CONFIG_OPTIONS` / `FORMULA_OPERATORS`
54
+ - `schema_common` — op: `SET_DISPLAY_NAME`
55
+ - `schema_component` — op: `ADD` / `DELETE` / `LIST_PAGES` / `GET_CONTEXT_INFO` / `GET_INFO` / `GET_CHILDREN_INFO` / `UPDATE`
56
+ - `schema_condition_expr` — op: `DELETE_TERM` / `LIST_OPERATORS` / `INSERT_TERM` / `NEST` / `TOGGLE_AND_OR` / `TOGGLE_NOT` / `SET_OPERATOR`
57
+ - `schema_conditional_branch` — op: `DELETE` / `INSERT` / `REORDER` / `UPDATE`
58
+ - `schema_create_binding` — op: `CONDITIONAL` / `CONST` / `FORMULA` / `OPTION` / `SET_FORMULA_CONFIG`
59
+ - `schema_request_filter` — op: `ADD_FILTER` / `ADD_CONDITION` / `ADD_SORT` / `DELETE_FILTER` / `DELETE_CONDITION` / `DELETE_SORT` / `CONTEXT` / `NEST_CONDITION` / `REORDER_FILTERS` / `REORDER_SORT` / `TOGGLE_CONDITION_AND_OR` / `TOGGLE_CONDITION_NOT` / `UPDATE_FILTER` / `SET_CONDITION_OPERATOR` / `UPDATE_SORT`
60
+ - `schema_table` — op: `ADD_CONSTRAINTS` / `ADD_FIELDS_RELATIONS` / `ADD_TABLES` / `ADD_EXTENSION` / `DELETE_CONSTRAINTS` / `DELETE_FIELDS_RELATIONS` / `DELETE_TABLES` / `DELETE_EXTENSION` / `LIST_NAMES` / `LIST_EMBEDDING_MODELS` / `GET_INFOS`
61
+ - `schema_type` — op: `ADD_ENUMS` / `ADD_OBJECTS` / `ADD_FIELDS` / `DELETE_ENUMS` / `DELETE_OBJECTS` / `DELETE_FIELDS` / `LIST_ENUMS` / `LIST_OBJECTS` / `UPDATE_ENUMS` / `UPDATE_OBJECTS`
62
+ <!-- GENERATED-ZTYPE-TOOLS:END -->
63
+ - **Schema 编辑 — 底层**: `ztype_tool_calls`、`apply_schema_diff`。
64
+ - **部署**: `sync_backend`。
65
+ - **数据 (Supportservice)**: `supportservice_graphql`（原始 GraphQL：查询、变更、聚合、关联、调用 actionflow/AI agent、预签名素材上传）。
66
+ - **日志与文档**: `search_logs`、`search_docs`、`get_doc_page`。
67
+ - **ZB**: `zb_graphql_query`。
68
+ - **工作区**: `set_current_working_directory`（设置当前工作目录，通常自动处理）。
69
+ - **Escape hatch**: `agent_command`（直接调用任意内部命令）。
54
70
 
55
71
  ## CLI / Daemon
56
72