@qingflow-tech/qingflow-app-builder-mcp 1.0.21 → 1.0.23

package/README.md

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

package/package.json

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

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

@@ -65,7 +65,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     member_candidates.add_argument("--record-id")
     member_candidates.add_argument("--workflow-node-id", type=int)
     member_candidates.add_argument("--fields-file")
-    member_candidates.set_defaults(handler=_handle_member_candidates, format_hint="")
+    member_candidates.set_defaults(handler=_handle_member_candidates, format_hint="record_candidates")
 
     department_candidates = record_subparsers.add_parser("department-candidates", help="读取部门字段候选项")
     department_candidates.add_argument("--app-key", required=True)
@@ -76,7 +76,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     department_candidates.add_argument("--record-id")
     department_candidates.add_argument("--workflow-node-id", type=int)
     department_candidates.add_argument("--fields-file")
-    department_candidates.set_defaults(handler=_handle_department_candidates, format_hint="")
+    department_candidates.set_defaults(handler=_handle_department_candidates, format_hint="record_candidates")
 
     list_parser = record_subparsers.add_parser("list", help="列出记录")
     list_parser.add_argument("--app-key", required=True)

package/src/qingflow_mcp/cli/formatters.py

@@ -395,6 +395,63 @@ def _format_record_access(result: dict[str, Any]) -> str:
     return "\n".join(lines) + "\n"
 
 
+def _format_record_candidates(result: dict[str, Any]) -> str:
+    data = result.get("data") if isinstance(result.get("data"), dict) else {}
+    selection = data.get("selection") if isinstance(data.get("selection"), dict) else {}
+    pagination = data.get("pagination") if isinstance(data.get("pagination"), dict) else {}
+    items = data.get("items") if isinstance(data.get("items"), list) else []
+    lines = [
+        f"Field: {selection.get('field_title') or '-'} ({selection.get('field_id') or '-'})",
+        f"App Key: {selection.get('app_key') or '-'}",
+        f"Scope Source: {data.get('scope_source') or '-'}",
+        f"Keyword: {selection.get('keyword') if selection.get('keyword') not in (None, '') else '-'}",
+    ]
+    if selection.get("record_id") not in (None, "") or selection.get("workflow_node_id") not in (None, "") or selection.get("fields_present"):
+        lines.append(
+            "Runtime Context: "
+            f"record_id={selection.get('record_id') or '-'} / "
+            f"workflow_node_id={selection.get('workflow_node_id') or '-'} / "
+            f"fields_present={selection.get('fields_present')}"
+        )
+    if pagination:
+        lines.append(
+            "Pagination: "
+            f"page={pagination.get('page')} / "
+            f"page_size={pagination.get('page_size')} / "
+            f"returned={pagination.get('returned_items')} / "
+            f"total={pagination.get('reported_total')} / "
+            f"pages={pagination.get('page_amount')}"
+        )
+    lines.append(f"Candidates: {len(items)}")
+    for item in items[:20]:
+        if not isinstance(item, dict):
+            lines.append(f"- {item}")
+            continue
+        parts = [str(item.get("value") or item.get("name") or item.get("id") or "-")]
+        if item.get("id") not in (None, ""):
+            parts.append(f"id={item.get('id')}")
+        if item.get("userId") not in (None, ""):
+            parts.append(f"userId={item.get('userId')}")
+        if item.get("email") not in (None, ""):
+            parts.append(f"email={item.get('email')}")
+        if item.get("path") not in (None, ""):
+            parts.append(f"path={item.get('path')}")
+        sources = item.get("sources") if isinstance(item.get("sources"), list) else []
+        source_labels = [
+            str(source.get("kind"))
+            for source in sources
+            if isinstance(source, dict) and source.get("kind") not in (None, "")
+        ]
+        if source_labels:
+            parts.append("sources=" + ",".join(source_labels))
+        lines.append("- " + " / ".join(parts))
+    if len(items) > 20:
+        lines.append(f"... {len(items) - 20} more")
+    _append_warnings(lines, result.get("warnings"))
+    _append_verification(lines, result.get("verification"))
+    return "\n".join(lines) + "\n"
+
+
 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 {}
@@ -1021,18 +1078,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:
@@ -1273,6 +1388,7 @@ _FORMATTERS = {
     "chart_get": _format_chart_get,
     "record_list": _format_record_list,
     "record_access": _format_record_access,
+    "record_candidates": _format_record_candidates,
     "record_get": _format_record_get,
     "record_logs": _format_record_logs,
     "record_write": _format_record_write,