@josephyan/qingflow-app-builder-mcp 0.2.0-beta.20 → 0.2.0-beta.21

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @josephyan/qingflow-app-builder-mcp@0.2.0-beta.20
+npm install @josephyan/qingflow-app-builder-mcp@0.2.0-beta.21
 ```
 
 Run:
 
 ```bash
-npx -y -p @josephyan/qingflow-app-builder-mcp@0.2.0-beta.20 qingflow-app-builder-mcp
+npx -y -p @josephyan/qingflow-app-builder-mcp@0.2.0-beta.21 qingflow-app-builder-mcp
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josephyan/qingflow-app-builder-mcp",
-  "version": "0.2.0-beta.20",
+  "version": "0.2.0-beta.21",
   "description": "Builder MCP for Qingflow app/package/system design and staged solution workflows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qingflow-mcp"
-version = "0.2.0b20"
+version = "0.2.0b21"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

package/src/qingflow_mcp/__init__.py

@@ -2,4 +2,4 @@ from __future__ import annotations
 
 __all__ = ["__version__"]
 
-__version__ = "0.2.0b20"
+__version__ = "0.2.0b21"

package/src/qingflow_mcp/server.py

@@ -29,15 +29,15 @@ def build_server() -> FastMCP:
             "Use auth_login first, then workspace_list and workspace_select. "
             "All resource tools operate with the logged-in user's Qingflow permissions.\n\n"
             "For analytics, use record_schema_get first, let the model build field_id-based DSL, "
-            "then call record_analyze. Use record_query for list/detail browsing only.\n\n"
+            "then call record_analyze. For operational record reads, use record_schema_get first, then record_list or record_get. "
+            "For writes, use record_schema_get and then record_write with mode=plan or apply.\n\n"
             "Task Center (待办/已办) handling:\n"
-            "- Use task_statistics to get counts of pending tasks (todo_count), timeouts, urged, etc.\n"
-            "- Use task_list to query tasks. Type values: 1=todo (待办), 2=initiated (我发起的), 3=cc (抄送), 5=done (已办).\n"
-            "- Use task_list_grouped to get tasks grouped by form/worksheet.\n"
+            "- Use task_summary to get headline counts.\n"
+            "- Use task_list for flat task browsing with task_box and flow_status.\n"
+            "- Use task_facets when worksheet or workflow-node buckets matter.\n"
             "- Use task_mark_read to mark a specific task as read.\n"
             "- Use task_urge to send an urgent reminder for a pending task.\n"
-            "- Process status values: 1=all, 2=processing, 3=passed, 4=refused, 5=need_supply, 6=urged, 7=timeout, 8=pre_timeout, 9=unread.\n"
-            "- After identifying the exact task node and record, use record_approve, record_reject, record_rollback, record_transfer, record_reassign, or record_countersign as needed."
+            "- After identifying the exact task node and record, use task_approve, task_reject, task_rollback, or task_transfer as needed."
         ),
     )
     sessions = SessionStore()

package/src/qingflow_mcp/server_app_user.py

@@ -18,9 +18,11 @@ def build_user_server() -> FastMCP:
     server = FastMCP(
         "Qingflow App User MCP",
         instructions=(
-            "Use this server for Qingflow record queries, schema-first analytics via record_schema_get and record_analyze, "
-            "record writes, task center operations, directory lookups, and approval actions. "
-            "Use record_query for list/detail reads only. Avoid builder-side app or schema changes here."
+            "Use this server for Qingflow operational workflows with a schema-first path. "
+            "For records, start with record_schema_get, then choose record_list, record_get, or record_write. "
+            "For analytics, switch to record_schema_get and record_analyze. "
+            "For task center, use task_summary, task_list, and task_facets before any explicit task action. "
+            "Avoid builder-side app or schema changes here."
         ),
     )
     sessions = SessionStore()
@@ -137,189 +139,12 @@ def build_user_server() -> FastMCP:
             bucket_type=bucket_type,
             path_id=path_id,
             file_related_url=file_related_url,
-        )
+    )
 
     RecordTools(sessions, backend).register(server)
     DirectoryTools(sessions, backend).register(server)
-
-    @server.tool()
-    def record_comment_add(
-        profile: str = DEFAULT_PROFILE,
-        app_key: str = "",
-        apply_id: int = 0,
-        payload: dict | None = None,
-    ) -> dict:
-        return approvals.record_comment_add(profile=profile, app_key=app_key, apply_id=apply_id, payload=payload or {})
-
-    @server.tool()
-    def record_comment_list(
-        profile: str = DEFAULT_PROFILE,
-        app_key: str = "",
-        apply_id: int = 0,
-        page_size: int = 20,
-        list_type: int | None = None,
-        page_num: int | None = 1,
-    ) -> dict:
-        return approvals.record_comment_list(
-            profile=profile,
-            app_key=app_key,
-            apply_id=apply_id,
-            page_size=page_size,
-            list_type=list_type,
-            page_num=page_num,
-        )
-
-    @server.tool()
-    def record_comment_mention_candidates(
-        profile: str = DEFAULT_PROFILE,
-        app_key: str = "",
-        apply_id: int = 0,
-        page_size: int = 20,
-        page_num: int = 1,
-        list_type: int | None = None,
-        keyword: str | None = None,
-    ) -> dict:
-        return approvals.record_comment_mention_candidates(
-            profile=profile,
-            app_key=app_key,
-            apply_id=apply_id,
-            page_size=page_size,
-            page_num=page_num,
-            list_type=list_type,
-            keyword=keyword,
-        )
-
-    @server.tool()
-    def record_comment_mark_read(profile: str = DEFAULT_PROFILE, app_key: str = "", apply_id: int = 0) -> dict:
-        return approvals.record_comment_mark_read(profile=profile, app_key=app_key, apply_id=apply_id)
-
-    @server.tool()
-    def record_comment_stats(profile: str = DEFAULT_PROFILE, app_key: str = "", apply_id: int = 0) -> dict:
-        return approvals.record_comment_stats(profile=profile, app_key=app_key, apply_id=apply_id)
-
-    @server.tool()
-    def task_list(
-        profile: str = DEFAULT_PROFILE,
-        type: int = 1,
-        process_status: int = 1,
-        app_key: str | None = None,
-        node_id: int | None = None,
-        search_key: str | None = None,
-        page_num: int = 1,
-        page_size: int = 20,
-        create_time_asc: bool | None = None,
-    ) -> dict:
-        return tasks.task_list(
-            profile=profile,
-            type=type,
-            process_status=process_status,
-            app_key=app_key,
-            node_id=node_id,
-            search_key=search_key,
-            page_num=page_num,
-            page_size=page_size,
-            create_time_asc=create_time_asc,
-        )
-
-    @server.tool()
-    def task_list_grouped(
-        profile: str = DEFAULT_PROFILE,
-        type: int = 1,
-        process_status: int = 1,
-        app_key: str | None = None,
-        node_id: int | None = None,
-        search_key: str | None = None,
-        page_num: int = 1,
-        page_size: int = 20,
-    ) -> dict:
-        return tasks.task_list_grouped(
-            profile=profile,
-            type=type,
-            process_status=process_status,
-            app_key=app_key,
-            node_id=node_id,
-            search_key=search_key,
-            page_num=page_num,
-            page_size=page_size,
-        )
-
-    @server.tool()
-    def task_statistics(profile: str = DEFAULT_PROFILE, app_key: str | None = None) -> dict:
-        return tasks.task_statistics(profile=profile, app_key=app_key)
-
-    @server.tool()
-    def task_urge(profile: str = DEFAULT_PROFILE, app_key: str = "", row_record_id: int = 0) -> dict:
-        return tasks.task_urge(profile=profile, app_key=app_key, row_record_id=row_record_id)
-
-    @server.tool(description=approvals._high_risk_tool_description(operation="approve", target="workflow task"))
-    def task_approve(
-        profile: str = DEFAULT_PROFILE,
-        app_key: str = "",
-        apply_id: int = 0,
-        payload: dict | None = None,
-    ) -> dict:
-        return approvals.record_approve(profile=profile, app_key=app_key, apply_id=apply_id, payload=payload or {})
-
-    @server.tool(description=approvals._high_risk_tool_description(operation="reject", target="workflow task"))
-    def task_reject(
-        profile: str = DEFAULT_PROFILE,
-        app_key: str = "",
-        apply_id: int = 0,
-        payload: dict | None = None,
-    ) -> dict:
-        return approvals.record_reject(profile=profile, app_key=app_key, apply_id=apply_id, payload=payload or {})
-
-    @server.tool()
-    def task_rollback_candidates(
-        profile: str = DEFAULT_PROFILE,
-        app_key: str = "",
-        apply_id: int = 0,
-        audit_node_id: int = 0,
-    ) -> dict:
-        return approvals.record_rollback_candidates(
-            profile=profile,
-            app_key=app_key,
-            apply_id=apply_id,
-            audit_node_id=audit_node_id,
-        )
-
-    @server.tool()
-    def task_rollback(
-        profile: str = DEFAULT_PROFILE,
-        app_key: str = "",
-        apply_id: int = 0,
-        payload: dict | None = None,
-    ) -> dict:
-        return approvals.record_rollback(profile=profile, app_key=app_key, apply_id=apply_id, payload=payload or {})
-
-    @server.tool()
-    def task_transfer_candidates(
-        profile: str = DEFAULT_PROFILE,
-        app_key: str = "",
-        apply_id: int = 0,
-        page_size: int = 20,
-        page_num: int = 1,
-        audit_node_id: int = 0,
-        keyword: str | None = None,
-    ) -> dict:
-        return approvals.record_transfer_candidates(
-            profile=profile,
-            app_key=app_key,
-            apply_id=apply_id,
-            page_size=page_size,
-            page_num=page_num,
-            audit_node_id=audit_node_id,
-            keyword=keyword,
-        )
-
-    @server.tool()
-    def task_transfer(
-        profile: str = DEFAULT_PROFILE,
-        app_key: str = "",
-        apply_id: int = 0,
-        payload: dict | None = None,
-    ) -> dict:
-        return approvals.record_transfer(profile=profile, app_key=app_key, apply_id=apply_id, payload=payload or {})
+    approvals.register(server)
+    tasks.register(server)
 
     return server