@qingflow-tech/qingflow-app-builder-mcp 1.0.22 → 1.0.24

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @qingflow-tech/qingflow-app-builder-mcp@1.0.22
+npm install @qingflow-tech/qingflow-app-builder-mcp@1.0.24
 ```
 
 Run:
 
 ```bash
-npx -y -p @qingflow-tech/qingflow-app-builder-mcp@1.0.22 qingflow-app-builder-mcp
+npx -y -p @qingflow-tech/qingflow-app-builder-mcp@1.0.24 qingflow-app-builder-mcp
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qingflow-tech/qingflow-app-builder-mcp",
-  "version": "1.0.22",
+  "version": "1.0.24",
   "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 = "1.0.22"
+version = "1.0.24"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

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

@@ -26,7 +26,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     schema_applicant = schema_subparsers.add_parser("applicant", help=argparse.SUPPRESS)
     schema_applicant.add_argument("--app-key", required=True)
-    schema_applicant.set_defaults(handler=_handle_schema_applicant, format_hint="")
+    schema_applicant.set_defaults(handler=_handle_schema_applicant, format_hint="record_schema")
     schema_subparsers._choices_actions = [  # type: ignore[attr-defined]
         action
         for action in schema_subparsers._choices_actions  # type: ignore[attr-defined]
@@ -36,25 +36,25 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     schema_browse = schema_subparsers.add_parser("browse", help="读取浏览视图表结构")
     schema_browse.add_argument("--app-key", required=True)
     schema_browse.add_argument("--view-id", required=True)
-    schema_browse.set_defaults(handler=_handle_schema_browse, format_hint="")
+    schema_browse.set_defaults(handler=_handle_schema_browse, format_hint="record_schema")
 
     schema_insert = schema_subparsers.add_parser("insert", help="读取新增记录表结构")
     schema_insert.add_argument("--app-key", required=True)
-    schema_insert.set_defaults(handler=_handle_schema_insert, format_hint="")
+    schema_insert.set_defaults(handler=_handle_schema_insert, format_hint="record_schema")
 
     schema_update = schema_subparsers.add_parser("update", help="读取更新记录表结构")
     schema_update.add_argument("--app-key", required=True)
     schema_update.add_argument("--record-id", required=True)
     schema_update.add_argument("--view-id")
-    schema_update.set_defaults(handler=_handle_schema_update, format_hint="")
+    schema_update.set_defaults(handler=_handle_schema_update, format_hint="record_schema")
 
     schema_import = schema_subparsers.add_parser("import", help="读取导入表结构")
     schema_import.add_argument("--app-key", required=True)
-    schema_import.set_defaults(handler=_handle_schema_import, format_hint="")
+    schema_import.set_defaults(handler=_handle_schema_import, format_hint="record_schema")
 
     schema_code_block = schema_subparsers.add_parser("code-block", help="读取代码块执行表结构")
     schema_code_block.add_argument("--app-key", required=True)
-    schema_code_block.set_defaults(handler=_handle_schema_code_block, format_hint="")
+    schema_code_block.set_defaults(handler=_handle_schema_code_block, format_hint="record_schema")
 
     member_candidates = record_subparsers.add_parser("member-candidates", help="读取成员字段候选项")
     member_candidates.add_argument("--app-key", required=True)

package/src/qingflow_mcp/cli/formatters.py

@@ -452,6 +452,102 @@ def _format_record_candidates(result: dict[str, Any]) -> str:
     return "\n".join(lines) + "\n"
 
 
+def _format_record_schema(result: dict[str, Any]) -> str:
+    lines = [
+        f"Status: {result.get('status') or '-'}",
+        f"App Key: {result.get('app_key') or '-'}",
+        f"Schema Scope: {result.get('schema_scope') or '-'}",
+    ]
+    if result.get("record_id") not in (None, ""):
+        lines.append(f"Record ID: {result.get('record_id')}")
+    view_resolution = result.get("view_resolution") if isinstance(result.get("view_resolution"), dict) else {}
+    view_id = view_resolution.get("view_id") or view_resolution.get("id")
+    if view_id:
+        lines.append(f"View ID: {view_id}")
+    if result.get("schema_fingerprint") not in (None, ""):
+        lines.append(f"Schema Fingerprint: {result.get('schema_fingerprint')}")
+
+    sections: list[tuple[str, list[Any]]] = []
+    for key, label in (
+        ("fields", "Fields"),
+        ("required_fields", "Required Fields"),
+        ("optional_fields", "Optional Fields"),
+        ("runtime_linked_required_fields", "Runtime Linked Required Fields"),
+        ("writable_fields", "Writable Fields"),
+        ("columns", "Import Columns"),
+        ("input_fields", "Input Fields"),
+        ("code_block_fields", "Code Block Fields"),
+        ("ambiguous_fields", "Ambiguous Fields"),
+    ):
+        value = result.get(key)
+        if isinstance(value, list):
+            sections.append((label, value))
+
+    for label, items in sections:
+        lines.append(f"{label}: {len(items)}")
+        for item in items[:20]:
+            if isinstance(item, dict):
+                lines.append("- " + _schema_item_summary(item))
+            else:
+                lines.append(f"- {item}")
+        if len(items) > 20:
+            lines.append(f"... {len(items) - 20} more")
+
+    payload_template = result.get("payload_template") if isinstance(result.get("payload_template"), dict) else {}
+    if payload_template:
+        lines.append("Payload Template Keys: " + ", ".join(str(key) for key in list(payload_template.keys())[:20]))
+
+    available_routes = result.get("available_update_routes") if isinstance(result.get("available_update_routes"), list) else []
+    if available_routes:
+        route_labels = [
+            str(item.get("route_type") or item.get("endpoint_kind") or item.get("view_id") or "-")
+            for item in available_routes[:8]
+            if isinstance(item, dict)
+        ]
+        lines.append("Available Update Routes: " + ", ".join(route_labels))
+
+    suggested_next_call = result.get("suggested_next_call") if isinstance(result.get("suggested_next_call"), dict) else {}
+    if suggested_next_call.get("tool_name"):
+        lines.append(f"Suggested Next Call: {suggested_next_call.get('tool_name')}")
+
+    _append_warnings(lines, result.get("warnings"))
+    _append_verification(lines, result.get("verification"))
+    return "\n".join(lines) + "\n"
+
+
+def _schema_item_summary(item: dict[str, Any]) -> str:
+    field_id = (
+        item.get("field_id")
+        or item.get("que_id")
+        or item.get("queId")
+        or item.get("id")
+        or item.get("selector")
+        or "-"
+    )
+    title = item.get("title") or item.get("que_title") or item.get("queTitle") or item.get("name") or item.get("selector") or "-"
+    kind = item.get("kind") or item.get("write_kind") or item.get("que_type") or item.get("queType") or item.get("type") or "-"
+    parts = [f"{title} ({field_id})", f"kind={kind}"]
+    for key in ("required", "writable", "may_become_required", "requires_lookup", "requires_upload"):
+        if key in item:
+            parts.append(f"{key}={item.get(key)}")
+    if item.get("import_value_format") not in (None, ""):
+        parts.append(f"import_value_format={item.get('import_value_format')}")
+    if item.get("target_app_key") not in (None, ""):
+        parts.append(f"target_app_key={item.get('target_app_key')}")
+    options = item.get("options") if isinstance(item.get("options"), list) else []
+    if options:
+        parts.append(f"options={len(options)}")
+    bound_outputs = item.get("bound_output_fields") if isinstance(item.get("bound_output_fields"), list) else []
+    if bound_outputs:
+        parts.append("bound_outputs=" + ",".join(str(value) for value in bound_outputs[:5]))
+    aliases = item.get("configured_aliases") if isinstance(item.get("configured_aliases"), list) else []
+    if aliases:
+        parts.append("aliases=" + ",".join(str(value) for value in aliases[:5]))
+    if item.get("format_hint") not in (None, ""):
+        parts.append(f"hint={item.get('format_hint')}")
+    return " / ".join(parts)
+
+
 def _format_record_get(result: dict[str, Any]) -> str:
     record = result.get("record") if isinstance(result.get("record"), dict) else {}
     app = result.get("app") if isinstance(result.get("app"), dict) else {}
@@ -1078,18 +1174,76 @@ def _format_export_direct(result: dict[str, Any]) -> str:
 
 def _format_builder_summary(result: dict[str, Any]) -> str:
     lines = []
-    if "status" in result:
-        lines.append(f"Status: {result.get('status')}")
-    if "app_key" in result:
-        lines.append(f"App Key: {result.get('app_key')}")
-    if "dash_key" in result:
-        lines.append(f"Dash Key: {result.get('dash_key')}")
-    if "verified" in result:
-        lines.append(f"Verified: {result.get('verified')}")
+    emitted: set[str] = set()
+    for key, label in (
+        ("status", "Status"),
+        ("message", "Message"),
+        ("app_key", "App Key"),
+        ("dash_key", "Dash Key"),
+        ("view_key", "View Key"),
+        ("chart_id", "Chart ID"),
+        ("package_id", "Package ID"),
+        ("verified", "Verified"),
+        ("write_executed", "Write Executed"),
+        ("delete_executed", "Delete Executed"),
+        ("safe_to_retry", "Safe To Retry"),
+    ):
+        if key in result and result.get(key) not in (None, ""):
+            lines.append(f"{label}: {result.get(key)}")
+            emitted.add(key)
+    for key, value in result.items():
+        if key in emitted or key in {"data", "warnings", "verification", "details", "result", "raw"}:
+            continue
+        if isinstance(value, (str, int, float, bool)) or value is None:
+            lines.append(f"{key}: {value}")
     data = result.get("data")
     if isinstance(data, dict):
         scalar_lines = _dict_scalar_lines(data)
-        lines.extend(scalar_lines[:8])
+        if scalar_lines:
+            lines.append("Data:")
+            lines.extend(f"- {line}" for line in scalar_lines[:12])
+    for key in (
+        "items",
+        "apps",
+        "fields",
+        "sections",
+        "components",
+        "questions",
+        "views",
+        "charts",
+        "buttons",
+        "associations",
+        "package_ids",
+        "app_keys",
+    ):
+        value = result.get(key)
+        if isinstance(value, list):
+            lines.append(f"{key}: {len(value)}")
+    components = result.get("components") if isinstance(result.get("components"), list) else []
+    if components:
+        lines.append("Component Refs:")
+        for item in components[:8]:
+            if not isinstance(item, dict):
+                continue
+            chart_ref = item.get("chart_ref") if isinstance(item.get("chart_ref"), dict) else {}
+            view_ref = item.get("view_ref") if isinstance(item.get("view_ref"), dict) else {}
+            source_type = item.get("source_type") or item.get("type") or "unknown"
+            title = item.get("title")
+            if chart_ref:
+                lines.append(f"- {source_type}: {title or chart_ref.get('chart_name') or '-'} / chart_id={chart_ref.get('chart_id') or '-'}")
+            elif view_ref:
+                lines.append(
+                    f"- {source_type}: {title or view_ref.get('view_name') or '-'} / "
+                    f"view_key={view_ref.get('view_key') or '-'} / app_key={view_ref.get('app_key') or '-'}"
+                )
+            else:
+                lines.append(f"- {source_type}: {title or '-'}")
+    if isinstance(result.get("base"), dict):
+        lines.append(f"Base Keys: {', '.join(str(key) for key in list(result['base'].keys())[:12])}")
+    if isinstance(result.get("config"), dict):
+        lines.append(f"Config Keys: {', '.join(str(key) for key in list(result['config'].keys())[:12])}")
+    if isinstance(result.get("visibility"), dict):
+        lines.append(f"Visibility Keys: {', '.join(str(key) for key in list(result['visibility'].keys())[:12])}")
     _append_warnings(lines, result.get("warnings"))
     _append_verification(lines, result.get("verification"))
     if not lines:
@@ -1331,6 +1485,7 @@ _FORMATTERS = {
     "record_list": _format_record_list,
     "record_access": _format_record_access,
     "record_candidates": _format_record_candidates,
+    "record_schema": _format_record_schema,
     "record_get": _format_record_get,
     "record_logs": _format_record_logs,
     "record_write": _format_record_write,