@qingflow-tech/qingflow-cli 1.1.51 → 1.1.54

package/src/qingflow_mcp/cli/commands/data.py

@@ -0,0 +1,134 @@
+from __future__ import annotations
+
+import argparse
+import textwrap
+
+from ..context import CliContext
+from .common import load_list_arg, require_list_arg, require_object_arg, raise_config_error
+
+
+def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
+    parser = subparsers.add_parser(
+        "data",
+        help="默认应用数据查询与直接增删改",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=textwrap.dedent("""
+            JSON 文件约定：
+              columns.json  [101, 102]
+              where.json    [{"field_id": 101, "op": "eq", "value": "A"}]
+              sort.json     [{"field_id": 101, "direction": "asc"}]
+              items.json    [{"fields": {"101": "A"}}]
+              fields.json   {"101": "B"}
+            query/get/insert/update 默认返回 field_capabilities；可用 --no-schema 关闭。
+        """).strip(),
+    )
+    commands = parser.add_subparsers(dest="data_command", required=True, metavar="{query,get,insert,update,delete}")
+
+    query = commands.add_parser(
+        "query", help="分页查询应用数据", formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog='最小示例：qingflow data query --app-key APP_1 --where-file where.json\n'
+               'where.json: [{"field_id": 101, "op": "eq", "value": "A"}]',
+    )
+    query.add_argument("--app-key", required=True)
+    query.add_argument("--columns-file", help='JSON 数组，例如 [101, 102]')
+    query.add_argument(
+        "--where-file",
+        help='JSON 数组；项为 {"field_id":101,"op":"eq","value":"A"}，in/not_in 的 value 必须为数组',
+    )
+    query.add_argument("--sort-file", help='JSON 数组，例如 [{"field_id":101,"direction":"asc"}]')
+    query.add_argument("--search", default="")
+    query.add_argument("--page", type=int, default=1)
+    query.add_argument("--page-size", type=int, default=100)
+    query.add_argument("--no-schema", action="store_false", dest="include_schema", default=True)
+    query.add_argument("--all", action="store_true", dest="all_pages")
+    query.add_argument("--output", choices=("json", "csv"), default="json")
+    query.set_defaults(handler=_handle_query, format_hint="data_query")
+
+    get = commands.add_parser("get", help="读取单条应用数据")
+    get.add_argument("--app-key", required=True)
+    get.add_argument("--record-id", required=True)
+    get.add_argument("--no-schema", action="store_false", dest="include_schema", default=True)
+    get.set_defaults(handler=_handle_get, format_hint="data_get")
+
+    insert = commands.add_parser(
+        "insert", help="新增应用数据", formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog='最小示例：items.json = [{"fields": {"101": "A"}}]',
+    )
+    insert.add_argument("--app-key", required=True)
+    insert.add_argument("--items-file", required=True, help='JSON 数组，项为 {"fields":{"字段ID":值}}')
+    insert.add_argument("--no-schema", action="store_false", dest="include_schema", default=True)
+    insert.set_defaults(handler=_handle_insert, format_hint="data_insert")
+
+    update = commands.add_parser(
+        "update", help="更新应用数据", formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog='最小示例：fields.json = {"101": "B"}',
+    )
+    update.add_argument("--app-key", required=True)
+    update.add_argument("--record-id", required=True)
+    update.add_argument("--fields-file", required=True, help='JSON 对象，键为字符串形式 field_id')
+    update.add_argument("--no-schema", action="store_false", dest="include_schema", default=True)
+    update.set_defaults(handler=_handle_update, format_hint="data_update")
+
+    delete = commands.add_parser("delete", help="删除应用数据")
+    delete.add_argument("--app-key", required=True)
+    delete.add_argument(
+        "--record-ids", action="append", default=[], metavar="ID[,ID...]",
+        help="待删除记录 ID；支持逗号分隔，也可重复传入",
+    )
+    delete.add_argument("--record-ids-file", help="附加的记录 ID JSON 数组文件")
+    delete.set_defaults(handler=_handle_delete, format_hint="data_delete")
+
+
+def _handle_query(args: argparse.Namespace, context: CliContext) -> dict:
+    if args.all_pages != (args.output == "csv"):
+        raise_config_error(
+            "--all 与 --output csv 必须同时使用。",
+            fix_hint="使用 `qingflow data query ... --all --output csv`，普通分页查询不要传这两个参数。",
+        )
+    return context.data.data_query(
+        profile=args.profile,
+        app_key=args.app_key,
+        columns=load_list_arg(args.columns_file, option_name="--columns-file"),
+        where=load_list_arg(args.where_file, option_name="--where-file"),
+        sort=load_list_arg(args.sort_file, option_name="--sort-file"),
+        search=args.search,
+        page=args.page,
+        page_size=args.page_size,
+        include_schema=args.include_schema,
+        all_pages=args.all_pages,
+        output=args.output,
+    )
+
+
+def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.data.data_get(
+        profile=args.profile, app_key=args.app_key, record_id=args.record_id, include_schema=args.include_schema
+    )
+
+
+def _handle_insert(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.data.data_insert(
+        profile=args.profile, app_key=args.app_key,
+        items=require_list_arg(args.items_file, option_name="--items-file"), include_schema=args.include_schema,
+    )
+
+
+def _handle_update(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.data.data_update(
+        profile=args.profile, app_key=args.app_key, record_id=args.record_id,
+        fields=require_object_arg(args.fields_file, option_name="--fields-file"), include_schema=args.include_schema,
+    )
+
+
+def _handle_delete(args: argparse.Namespace, context: CliContext) -> dict:
+    record_ids = [item.strip() for group in args.record_ids for item in group.split(",") if item.strip()]
+    record_ids.extend(load_list_arg(args.record_ids_file, option_name="--record-ids-file"))
+    if not record_ids:
+        raise_config_error(
+            "至少传入一个记录 ID。",
+            fix_hint="使用 `--record-ids ID[,ID...]`；也可附加 `--record-ids-file ids.json`。",
+        )
+    return context.data.data_delete(
+        profile=args.profile, app_key=args.app_key,
+        record_ids=record_ids,
+    )

package/src/qingflow_mcp/cli/commands/record.py

@@ -9,7 +9,7 @@ from .common import load_list_arg, load_object_arg, raise_config_error, require_
 
 
 def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
-    parser = subparsers.add_parser("record", help="记录与表结构")
+    parser = subparsers.add_parser("record", help="日志、附件、导入、代码块及 record 专项能力")
     record_subparsers = parser.add_subparsers(
         dest="record_command",
         required=True,

package/src/qingflow_mcp/cli/context.py

@@ -11,6 +11,7 @@ from ..tools.ai_builder_tools import AiBuilderTools
 from ..tools.app_tools import AppTools
 from ..tools.auth_tools import AuthTools
 from ..tools.code_block_tools import CodeBlockTools
+from ..tools.data_tools import DataTools
 from ..tools.export_tools import ExportTools
 from ..tools.feedback_tools import FeedbackTools
 from ..tools.file_tools import FileTools
@@ -33,6 +34,7 @@ class CliContext:
     app: AppTools
     resource: ResourceReadTools
     record: RecordTools
+    data: DataTools
     code_block: CodeBlockTools
     imports: ImportTools
     exports: ExportTools
@@ -64,6 +66,7 @@ def build_cli_context() -> CliContext:
         app=AppTools(sessions, backend),
         resource=ResourceReadTools(sessions, backend),
         record=RecordTools(sessions, backend),
+        data=DataTools(sessions, backend),
         code_block=CodeBlockTools(sessions, backend),
         imports=ImportTools(sessions, backend),
         exports=ExportTools(sessions, backend),

package/src/qingflow_mcp/cli/formatters.py

@@ -8,7 +8,10 @@ from typing import Any, TextIO
 def emit_text_result(result: dict[str, Any], *, hint: str, stream: TextIO) -> None:
     text = _format_cancelled_result(result)
     if text is None:
-        if _is_failed_result(result) and hint != "task_action_execute":
+        if hint in _DATA_FORMAT_HINTS:
+            # 数据面失败也必须保留 field_errors 与列表型 hints，不能先走通用失败裁剪。
+            text = _format_data_result(result)
+        elif _is_failed_result(result) and hint != "task_action_execute":
             text = _format_failed_result(result)
         else:
             formatter = _FORMATTERS.get(hint, _format_generic)
@@ -90,6 +93,92 @@ def _format_generic(result: dict[str, Any]) -> str:
     return "\n".join(lines) + "\n"
 
 
+def _format_data_result(result: dict[str, Any]) -> str:
+    lines = [f"Status: {result.get('status') or ('success' if result.get('ok') is not False else 'failed')}"]
+    if result.get("format") == "csv":
+        files = result.get("files") if isinstance(result.get("files"), list) else []
+        lines.extend(
+            [
+                f"Local dir: {result.get('local_dir') or '-'}",
+                f"Files: {len(files)}",
+            ]
+        )
+        for item in files:
+            if isinstance(item, dict):
+                lines.append(
+                    f"- part {item.get('part')}: {item.get('local_path')} ({item.get('row_count')} rows)"
+                )
+        lines.extend(
+            [
+                f"Rows: {result.get('row_count')}",
+                f"Complete: {result.get('complete')}",
+                f"Truncated: {result.get('truncated')}",
+                f"Safe for final conclusion: {result.get('safe_for_final_conclusion')}",
+                f"Stopped reason: {result.get('stopped_reason') or '-'}",
+            ]
+        )
+    access = result.get("access") if isinstance(result.get("access"), dict) else {}
+    if access:
+        sources = access.get("scope_sources") if isinstance(access.get("scope_sources"), list) else []
+        lines.append(
+            f"Access: level={access.get('level') or '-'} / can_write={access.get('can_write')}"
+            f" / scope_sources={','.join(str(item) for item in sources) or '-'}"
+        )
+
+    records = result.get("records") if isinstance(result.get("records"), dict) else {}
+    if records:
+        items = records.get("items") if isinstance(records.get("items"), list) else []
+        lines.append(
+            "Pagination: "
+            f"page={records.get('page')} / requested_page_size={records.get('requested_page_size')} / "
+            f"page_size={records.get('page_size')} / total={records.get('total')} / "
+            f"has_more={records.get('has_more')} / returned={len(items)}"
+        )
+    record = result.get("record") if isinstance(result.get("record"), dict) else {}
+    if record:
+        lines.append(f"Record ID: {record.get('record_id') or '-'}")
+    items = result.get("items") if isinstance(result.get("items"), list) else []
+    if items:
+        lines.append(f"Items: {len(items)}")
+
+    for key, label in (
+        ("error_code", "Error Code"),
+        ("message", "Message"),
+        ("write_executed", "Write Executed"),
+        ("retry_safe", "Retry Safe"),
+    ):
+        if key in result:
+            lines.append(f"{label}: {result.get(key)}")
+
+    field_errors = result.get("field_errors") if isinstance(result.get("field_errors"), list) else []
+    if field_errors:
+        lines.append("Field Errors:")
+        _append_data_field_errors(lines, field_errors)
+    for index, item in enumerate(items):
+        if not isinstance(item, dict) or not isinstance(item.get("field_errors"), list):
+            continue
+        lines.append(f"Item {index} Field Errors:")
+        _append_data_field_errors(lines, item["field_errors"])
+
+    hints = result.get("hints") if isinstance(result.get("hints"), list) else []
+    lines.append(f"Hints: {len(hints)}")
+    for hint in hints:
+        if isinstance(hint, dict):
+            lines.append(f"- {hint.get('code') or '-'}: {hint.get('message') or '-'}")
+        else:
+            lines.append(f"- {hint}")
+    return "\n".join(lines) + "\n"
+
+
+def _append_data_field_errors(lines: list[str], field_errors: list[Any]) -> None:
+    for error in field_errors:
+        if isinstance(error, dict):
+            lines.append(
+                f"- {error.get('path') or '-'}: {error.get('message') or '-'}"
+                f" / fix_hint={error.get('fix_hint') or '-'}"
+            )
+
+
 def _format_whoami(result: dict[str, Any]) -> str:
     lines = [
         f"User: {result.get('nick_name') or '-'} ({result.get('email') or '-'})",
@@ -1669,4 +1758,11 @@ _FORMATTERS = {
     "builder_summary": _format_builder_summary,
     "file_upload_local": _format_file_upload_local,
     "feedback_submit": _format_feedback_submit,
+    "data_query": _format_data_result,
+    "data_get": _format_data_result,
+    "data_insert": _format_data_result,
+    "data_update": _format_data_result,
+    "data_delete": _format_data_result,
 }
+
+_DATA_FORMAT_HINTS = {"data_query", "data_get", "data_insert", "data_update", "data_delete"}

package/src/qingflow_mcp/public_surface.py

@@ -40,6 +40,11 @@ USER_PUBLIC_TOOL_SPECS: tuple[PublicToolSpec, ...] = (
     PublicToolSpec(USER_DOMAIN, "workspace_select", ("workspace_select",), ("workspace", "select")),
     PublicToolSpec(USER_DOMAIN, "app_list", ("app_list",), ("app", "list"), cli_show_effective_context=True),
     PublicToolSpec(USER_DOMAIN, "app_get", ("app_get",), ("app", "get"), cli_show_effective_context=True),
+    PublicToolSpec(USER_DOMAIN, "data_query", ("data_query",), ("data", "query"), cli_show_effective_context=True),
+    PublicToolSpec(USER_DOMAIN, "data_get", ("data_get",), ("data", "get"), cli_show_effective_context=True),
+    PublicToolSpec(USER_DOMAIN, "data_insert", ("data_insert",), ("data", "insert"), cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(USER_DOMAIN, "data_update", ("data_update",), ("data", "update"), cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(USER_DOMAIN, "data_delete", ("data_delete",), ("data", "delete"), cli_show_effective_context=True, cli_context_write=True),
     PublicToolSpec(USER_DOMAIN, "portal_list", ("portal_list",), ("portal", "list"), cli_show_effective_context=True),
     PublicToolSpec(USER_DOMAIN, "portal_get", ("portal_get",), ("portal", "get"), cli_show_effective_context=True),
     PublicToolSpec(USER_DOMAIN, "view_get", ("view_get",), ("view", "get"), cli_show_effective_context=True),
@@ -173,6 +178,9 @@ BUILDER_PUBLIC_TOOL_SPECS: tuple[PublicToolSpec, ...] = (
     PublicToolSpec(BUILDER_DOMAIN, "app_flow_list_versions", ("app_flow_list_versions",), ("builder", "flow", "versions"), has_contract=True, cli_show_effective_context=True),
     PublicToolSpec(BUILDER_DOMAIN, "app_flow_restore_version", ("app_flow_restore_version",), ("builder", "flow", "restore"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
     PublicToolSpec(BUILDER_DOMAIN, "app_flow_apply", ("app_flow_apply",), ("builder", "flow", "apply"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_views_schema", ("app_views_schema",), ("builder", "views", "schema")),
+    PublicToolSpec(BUILDER_DOMAIN, "app_views_get", ("app_views_get",), ("builder", "views", "get"), cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_views_validate", (), ("builder", "views", "validate"), mcp_public=True),
     PublicToolSpec(BUILDER_DOMAIN, "app_views_apply", ("app_views_apply",), ("builder", "views", "apply"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
     PublicToolSpec(BUILDER_DOMAIN, "app_charts_apply", ("app_charts_apply",), ("builder", "charts", "apply"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
     PublicToolSpec(BUILDER_DOMAIN, "portal_apply", ("portal_apply",), ("builder", "portal", "apply"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),

package/src/qingflow_mcp/response_trim.py

@@ -51,9 +51,15 @@ COMMON_ERROR_DROP_TOP = {
 
 SUCCESS_POLICY_BY_TOOL: dict[str, TransformFn] = {}
 
-#: 这两个校验命令的产出契约明确包含 ok 字段（供阶段 2 SKILL.md 引用），
+#: 这些校验命令的产出契约明确包含 ok 字段（供阶段 2 SKILL.md 引用），
 #: 需在 success 裁剪时保留 ok（默认 COMMON_SUCCESS_DROP_TOP 会丢弃 ok）。
-_KEEP_OK_TOOLS = {"builder:app_form_validate_formula", "builder:app_form_validate_code_block", "builder:app_flow_validate"}
+#: `builder:app_views_validate`（views 声明式校验）同属校验类工具，ok 同样进产出契约。
+_KEEP_OK_TOOLS = {
+    "builder:app_form_validate_formula",
+    "builder:app_form_validate_code_block",
+    "builder:app_flow_validate",
+    "builder:app_views_validate",
+}
 
 
 def trim_public_response(tool_name: str | None, payload: dict[str, Any]) -> dict[str, Any]:
@@ -1310,6 +1316,9 @@ _register_policy(
         "app_flow_validate",
         "app_flow_list_versions",
         "app_flow_restore_version",
+        "app_views_schema",
+        "app_views_get",
+        "app_views_validate",
         "app_get_charts",
         "app_get_buttons",
         "app_get_associated_resources",

package/src/qingflow_mcp/server.py

@@ -7,6 +7,7 @@ from mcp.server.fastmcp import FastMCP
 from .backend_client import BackendClient
 from .session_store import SessionStore
 from .tools.app_tools import AppTools
+from .tools.data_tools import DataTools
 from .tools.auth_tools import AuthTools
 from .tools.code_block_tools import CodeBlockTools
 from .tools.feedback_tools import FeedbackTools
@@ -249,6 +250,7 @@ If the current MCP capability is unsupported, the workflow is awkward, or the us
     TaskContextTools(sessions, backend).register(server)
     RoleTools(sessions, backend).register(server)
     AppTools(sessions, backend).register(server)
+    DataTools(sessions, backend).register(server)
     QingbiReportTools(sessions, backend).register(server)
     PackageTools(sessions, backend).register(server)
     NavigationTools(sessions, backend).register(server)

package/src/qingflow_mcp/server_app_builder.py

@@ -56,8 +56,8 @@ def build_builder_server() -> FastMCP:
             "For builder delete/remove apply results, separate delete execution from readback verification: after DELETE is sent, resources expose delete_executed, readback_status, and safe_to_retry_delete=false. If readback_status is unavailable or still_exists, do not blindly repeat the delete; confirm later with app_get/view_get/chart_get or the relevant apply readback. Views/buttons use single-item readback; associated resources use one app-level resource-pool readback because there is no confirmed single-item GET. "
             "For builder write/apply results, separate write execution from final readback verification: status=partial_success with write_executed=true and safe_to_retry=false means the write was sent or succeeded, while final readback, publish verification, or metadata confirmation is pending or permission-restricted. Report it as written but unverified; do not repeat the same write blindly. "
             "For app_form_apply, pin the version from app_form_schema, preserve the complete body and existing IDs from a draft get, and configure data display through app-level spec.dataTitleField/spec.dataCoverField selectors rather than booleans on fields; App Builder MCP validates the declaration inside app_form_apply, while the CLI route has a separate static validate command. dataTitleField must resolve to exactly one top-level field for a non-empty body, while dataCoverField is optional and must resolve to a top-level attachment field. A root appKey means update and may include packageId; no appKey means create and requires packageId plus spec.appName. AppForm does not accept spec.icon or spec.color; creation derives a stable default icon and color from spec.appName. "
-            "For app_views_apply, keep fixed saved filters in filters and configure the frontend query panel separately with query_conditions; query_conditions.rows is a matrix of field names compiled to backend queryCondition queIds. New views default associated report/view display to visible with limit_type=all; existing views preserve their current associated display unless associated_resources is explicitly patched. View writes use ViewManagementAuth (beingViewManageStatus), falling back to DataManageAuth when advanced app permissions are not enabled. "
-            "For ordinary business buttons, declare them on the target view with app_views_apply.views[].action_buttons; app_views_apply writes the view first, then creates/binds the button. Use app_custom_buttons_apply only when the user explicitly asks to maintain existing standalone buttons outside view design, such as custom style/icon changes, cross-view reuse, deleting button bodies, bulk binding reorder, or exact qRobot/wings config. Button body writes require EditAppAuth; view_configs placement writes require ViewManagementAuth, matching the backend viewConfig route. For addData buttons, prefer action_buttons.target_app_key + field_mappings/default_values on the view path; do not ask agents to write raw que_relation unless maintaining a legacy config. field_mappings.source_field accepts source schema fields and supported system fields: 数据ID/row_record_id/apply_id/_id means current record id (-17), 编号/record_number means visible record number (0). To fill a target relation with the current record, map {'source_field': '数据ID', 'target_field': '目标引用字段'}; default_values is only for static constants. View button bindings merge by default; standalone view_configs are only for explicit maintenance. Builder view_key arguments are raw keys from app_get.views[].view_key and must not be prefixed with custom:. "
+            "For app_views_apply, keep fixed saved filters in filters and configure the frontend query panel separately with query_conditions; query_conditions.rows accepts field names, field IDs, or queIds and compiles them to backend queryCondition queIds, with queIds preferred. New views default associated report/view display to visible with limit_type=all; existing views preserve their current associated display unless associated_resources is explicitly patched. View writes use ViewManagementAuth (beingViewManageStatus), falling back to DataManageAuth when advanced app permissions are not enabled. "
+            "For ordinary business buttons, declare them on a new or full view with app_views_apply.upsert_view.action_buttons; app_views_apply writes the view first, then creates/binds the button. For an existing view, use patch_views[].set.action_buttons. Use app_custom_buttons_apply only when the user explicitly asks to maintain existing standalone buttons outside view design, such as custom style/icon changes, cross-view reuse, deleting button bodies, bulk binding reorder, or exact qRobot/wings config. Button body writes require EditAppAuth; view_configs placement writes require ViewManagementAuth, matching the backend viewConfig route. For addData buttons, prefer action_buttons.target_app_key + field_mappings/default_values on the view path; do not ask agents to write raw que_relation unless maintaining a legacy config. field_mappings.source_field accepts source schema fields and supported system fields: 数据ID/row_record_id/apply_id/_id means current record id (-17), 编号/record_number means visible record number (0). To fill a target relation with the current record, map {'source_field': '数据ID', 'target_field': '目标引用字段'}; default_values is only for static constants. View button bindings merge by default; standalone view_configs are only for explicit maintenance. Builder view_key arguments are raw keys from app_get.views[].view_key and must not be prefixed with custom:. "
             "For BI reports, keep report-body development separate from Qingflow in-app display: use app_charts_apply to create, update, remove, or reorder app-source QingBI chart bodies/configs with dataSourceType=qingflow; chart dimension/metric/filter/query fields must come from app_get_fields.chart_fields, not record schema or form-only fields; dataset BI reports are not created or edited by app_charts_apply yet and should be created in QingBI first, then attached with app_associated_resources_apply using report_source=dataset. "
             "For associated views/reports, use app_associated_resources_apply. Use match_mappings for filtering associated resources: dynamic current-record conditions use source_field, static conditions use value. match_mappings also supports 数据ID(-17) and 编号(0). Do not ask agents to write raw match_rules unless preserving a legacy backend config. "
             "For associated reports/views, use app_associated_resources_apply for both the app-level associated_resources pool and per-view display config; associated_item_id is the app-level form_asos_chart.id, and view_configs/remove/reorder may also pass an existing resource's chart_id/chart_key/view_key because the tool resolves those to the internal id. Before creating an associated resource, read app_get.associated_resources and reuse an existing matching target_app_key + view_key/chart_key through patch_resources; client_key only works inside one apply call and is not persisted. Do not ask agents to pass backend raw sourceType: views infer the internal Qingflow view source, reports default to BI app reports, and dataset reports use report_source=dataset. "
@@ -231,6 +231,32 @@ def build_builder_server() -> FastMCP:
     ) -> dict:
         return ai_builder.app_form_apply(profile=profile, spec=spec or {})
 
+    @server.tool()
+    def app_views_schema(
+        schema_version: str | None = None,
+        schema_kind: str | None = None,
+    ) -> dict:
+        """Get a complete views schema or a focused detail schema such as display or button-config."""
+        return ai_builder.app_views_schema(schema_version=schema_version, schema_kind=schema_kind)
+
+    @server.tool()
+    def app_views_get(
+        profile: str = DEFAULT_PROFILE,
+        app_key: str = "",
+        schema_version: str | None = None,
+        schema_kind: str | None = None,
+    ) -> dict:
+        return ai_builder.app_views_get(
+            profile=profile, app_key=app_key, schema_version=schema_version, schema_kind=schema_kind
+        )
+
+    @server.tool()
+    def app_views_validate(
+        declaration: dict | None = None,
+        schema_version: str | None = None,
+    ) -> dict:
+        return ai_builder.app_views_validate(declaration=declaration or {}, schema_version=schema_version)
+
     @server.tool(description=ai_builder._high_risk_tool_description(operation="delete", target="app configuration"))
     def app_delete(
         profile: str = DEFAULT_PROFILE,
@@ -445,8 +471,8 @@ def build_builder_server() -> FastMCP:
         return ai_builder.app_get_charts(profile=profile, app_key=app_key, app_keys=app_keys)
 
     @server.tool()
-    def app_get_buttons(profile: str = DEFAULT_PROFILE, app_key: str = "", app_keys: list[str] | None = None) -> dict:
-        return ai_builder.app_get_buttons(profile=profile, app_key=app_key, app_keys=app_keys)
+    def app_get_buttons(profile: str = DEFAULT_PROFILE, app_key: str = "", app_keys: list[str] | None = None, button_text: str | None = None) -> dict:
+        return ai_builder.app_get_buttons(profile=profile, app_key=app_key, app_keys=app_keys, button_text=button_text)
 
     @server.tool()
     def app_get_associated_resources(profile: str = DEFAULT_PROFILE, app_key: str = "", app_keys: list[str] | None = None) -> dict:
@@ -546,21 +572,19 @@ def build_builder_server() -> FastMCP:
         profile: str = DEFAULT_PROFILE,
         app_key: str = "",
         publish: bool = True,
-        upsert_views: list[dict] | None = None,
+        upsert_view: dict | None = None,
         patch_views: list[dict] | None = None,
         remove_views: list[str] | None = None,
-        apps: list[dict] | None = None,
-        views: list[dict] | None = None,
+        schema_version: str | None = None,
     ) -> dict:
         return ai_builder.app_views_apply(
             profile=profile,
             app_key=app_key,
             publish=publish,
-            upsert_views=upsert_views or [],
+            upsert_view=upsert_view,
             patch_views=patch_views or [],
             remove_views=remove_views or [],
-            apps=apps,
-            views=views,
+            schema_version=schema_version,
         )
 
     @server.tool()

package/src/qingflow_mcp/server_app_user.py

@@ -10,6 +10,7 @@ from .config import DEFAULT_PROFILE
 from .response_trim import USER_SERVER_METHOD_MAP, trim_error_response, trim_public_response, wrap_trimmed_methods
 from .session_store import SessionStore
 from .tools.app_tools import AppTools
+from .tools.data_tools import DataTools
 from .tools.auth_tools import AuthTools
 from .tools.code_block_tools import CodeBlockTools
 from .tools.directory_tools import DirectoryTools
@@ -242,6 +243,7 @@ If the current MCP capability is unsupported, the workflow is awkward, or the us
     backend = BackendClient()
     auth = wrap_trimmed_methods(AuthTools(sessions, backend), USER_SERVER_METHOD_MAP)
     apps = wrap_trimmed_methods(AppTools(sessions, backend), USER_SERVER_METHOD_MAP)
+    data_tools = wrap_trimmed_methods(DataTools(sessions, backend), USER_SERVER_METHOD_MAP)
     workspace = wrap_trimmed_methods(WorkspaceTools(sessions, backend), USER_SERVER_METHOD_MAP)
     file_tools = wrap_trimmed_methods(FileTools(sessions, backend), USER_SERVER_METHOD_MAP)
     imports = wrap_trimmed_methods(ImportTools(sessions, backend), USER_SERVER_METHOD_MAP)
@@ -395,6 +397,8 @@ If the current MCP capability is unsupported, the workflow is awkward, or the us
     def app_get(profile: str = DEFAULT_PROFILE, app_key: str = "") -> dict:
         return apps.app_get(profile=profile, app_key=app_key)
 
+    data_tools.register(server)
+
     @server.tool()
     def portal_list(profile: str = DEFAULT_PROFILE) -> dict:
         return resources.portal_list(profile=profile)

package/src/qingflow_mcp/solution/compiler/view_compiler.py

@@ -12,6 +12,7 @@ VIEW_TYPE_MAP = {
     ViewType.board: "boardView",
     ViewType.gantt: "ganttView",
     ViewType.hierarchy: "hierarchyView",
+    ViewType.calendar: "calendarView",
 }
 
 
@@ -32,7 +33,7 @@ def compile_views(entity: EntitySpec) -> list[dict[str, Any]]:
                     "viewgraphQueIds": list(view.field_ids),
                     "viewgraphQuestions": [],
                     "ordinal": ordinal,
-                    "beingShowTitleQue": view.type in (ViewType.card, ViewType.board, ViewType.gantt, ViewType.hierarchy),
+                    "beingShowTitleQue": view.type in (ViewType.card, ViewType.board, ViewType.gantt, ViewType.hierarchy, ViewType.calendar),
                     "beingShowCover": False,
                     "viewgraphLimitType": 1,
                     "viewgraphLimit": view.filters,