zion-mcp 1.0.12 → 2.0.1

package/README.md

@@ -8,6 +8,7 @@ Zion MCP Server 是 [FunctorZ (Zion)](https://functorz.com) 提供的官方 [Mod
 - **智能项目管理**: 支持模糊搜索项目，快速切换当前上下文。
 - **安全认证**: 基于 OAuth 的安全认证机制，确保您的数据安全。
 - **上下文感知**: 自动维护项目上下文，无需在每次请求时重复指定项目 ID。
+- **Gradle-style Daemon**: CLI 和 MCP 共用兼容 daemon，缓存项目 CRDT/ztype 状态；`--no-daemon` 可执行一次性命令并完全退出。
 
 ## 🚀 快速开始
 
@@ -39,13 +40,40 @@ Zion MCP Server 是 [FunctorZ (Zion)](https://functorz.com) 提供的官方 [Mod
 
 ## 🛠️ 可用工具 (Tools)
 
-连接成功后，AI 助手将获得以下能力：
+连接成功后，AI 助手将获得以下工具。部分为 **facade 工具**，通过 `op` 参数选择具体操作：
+
+- **Auth**: `auth`（op：`LOGIN` / `LOGOUT` / `WHOAMI` / `REAUTH`）、`get_account_profile`。
+- **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`）。
+- **Schema 会话**: `schema_session`（op：`LOAD` / `RELOAD` / `SYNC` / `SNAPSHOT` / `SAVE` / `VALIDATE`）、`schema_observe`（op：`STATE` / `EVENTS`）、`schema_status`。修改仅存于内存 CRDT 会话，需 `SAVE` + `sync_backend` 后才会生效上线。
+- **Schema 编辑 — 表与类型**: `schema_table`（op：`LIST_NAMES` / `GET_INFOS` / `ADD_TABLES` / `DELETE_TABLES` / `ADD_FIELDS_RELATIONS` / `DELETE_FIELDS_RELATIONS` / `ADD_CONSTRAINTS` / `DELETE_CONSTRAINTS`）、`schema_type`（op：`LIST_ENUMS` / `ADD_ENUMS` / `UPDATE_ENUMS` / `DELETE_ENUMS` / `LIST_OBJECTS` / `ADD_OBJECTS` / `UPDATE_OBJECTS` / `DELETE_OBJECTS`）。传入 `apply: true` 以上传 CRDT patch；这些命令会返回 ztype 校验诊断，包括后端 type-check 错误。
+- **Schema 编辑 — 数据绑定**: `schema_binding_inspect`（op：`BINDING_TYPE` / `BINDING_OPTIONS` / `FORMULA_OPERATORS`）、`schema_create_binding`（op：`CONST` / `OPTION` / `FORMULA` / `CONDITIONAL`）、`schema_conditional_branch`（op：`INSERT` / `UPDATE` / `DELETE` / `REORDER`）、`schema_condition_expr`（op：`INSERT_TERM` / `DELETE_TERM` / `NEST` / `TOGGLE_AND_OR` / `TOGGLE_NOT` / `LIST_OPERATORS` / `SET_OPERATOR`）。
+- **Schema 编辑 — 底层**: `ztype_tool_calls`、`apply_schema_diff`。
+- **部署**: `sync_backend`。
+- **数据 (Supportservice)**: `supportservice_graphql`（原始 GraphQL：查询、变更、聚合、关联、调用 actionflow/AI agent、预签名素材上传）。
+- **日志与文档**: `search_logs`、`search_docs`、`get_doc_page`。
+- **ZB**: `zb_graphql_query`。
+- **工作区**: `set_current_working_directory`（设置当前工作目录，通常自动处理）。
+- **Escape hatch**: `agent_command`（直接调用任意内部命令）。
+
+## CLI / Daemon
+
+```bash
+zion-mcp mcp
+zion-mcp --no-daemon whoami
+zion-mcp daemon start
+zion-mcp daemon status
+zion-mcp daemon stop
+zion-mcp projects search --args '{"query":"demo"}'
+zion-mcp project create --projectName test-media
+zion-mcp project metadata --projectExId "..."
+zion-mcp project resources --projectExId "..."
+zion-mcp schema load --args '{"projectExId":"..."}'
+zion-mcp schema validate --projectExId "..."
+zion-mcp project sync-backend --projectExId "..."
+zion-mcp support query --projectExId "..." --tableName account --limit 1
+```
 
-- **`set_current_working_directory`**: 设置当前工作目录（通常自动处理）。
-- **`get_projects`**: 搜索您的 Zion 项目列表。支持模糊搜索和分页。
-- **`set_current_project`**: 设置当前操作的项目上下文。
-- **`get_project_schema`**: 获取指定项目的详细 Schema 信息，帮助 AI 理解项目结构。
-- **`reauth`**: 当 Token 过期时触发重新认证。
+默认 CLI 命令会复用兼容 daemon；兼容性包含产品、Node 版本和平台、后端地址、认证用户、ztype/schema 版本、CRDT/json-joy 版本、工作区根目录和启动 flags。Daemon 空闲 3 小时退出；项目 Schema 会在空闲 5 分钟后卸载。
 
 ## 🔒 安全说明
 

package/bin/zion-mcp.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { main } from "../dist/server.js";
+import { main } from '../dist/server.js';
 
 main().catch((error) => {
-  console.error("[zion-mcp] Fatal error:", error);
+  console.error('[zion-mcp] Fatal error:', error);
   process.exit(1);
 });