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

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.22
 ```
 
 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.22 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.22",
   "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.22"
 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 {}
@@ -1273,6 +1330,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,