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

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @qingflow-tech/qingflow-app-builder-mcp@1.0.20
+npm install @qingflow-tech/qingflow-app-builder-mcp@1.0.22
 ```
 
 Run:
 
 ```bash
-npx -y -p @qingflow-tech/qingflow-app-builder-mcp@1.0.20 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.20",
+  "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.20"
+version = "1.0.22"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

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

@@ -11,7 +11,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     get_parser = chart_subparsers.add_parser("get", help="读取报表数据")
     get_parser.add_argument("--chart-id", required=True)
-    get_parser.set_defaults(handler=_handle_get, format_hint="generic")
+    get_parser.set_defaults(handler=_handle_get, format_hint="chart_get")
 
 
 def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:

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

@@ -10,11 +10,11 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     portal_subparsers = parser.add_subparsers(dest="portal_command", required=True)
 
     list_parser = portal_subparsers.add_parser("list", help="列出当前用户可访问的门户")
-    list_parser.set_defaults(handler=_handle_list, format_hint="generic")
+    list_parser.set_defaults(handler=_handle_list, format_hint="portal_list")
 
     get_parser = portal_subparsers.add_parser("get", help="读取门户内容清单")
     get_parser.add_argument("--dash-key", required=True)
-    get_parser.set_defaults(handler=_handle_get, format_hint="generic")
+    get_parser.set_defaults(handler=_handle_get, format_hint="portal_get")
 
 
 def _handle_list(args: argparse.Namespace, context: CliContext) -> dict:

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/commands/view.py

@@ -11,7 +11,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     get_parser = view_subparsers.add_parser("get", help="读取视图资源描述")
     get_parser.add_argument("--view-id", required=True)
-    get_parser.set_defaults(handler=_handle_get, format_hint="generic")
+    get_parser.set_defaults(handler=_handle_get, format_hint="view_get")
 
 
 def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:

package/src/qingflow_mcp/cli/formatters.py

@@ -227,6 +227,120 @@ def _format_app_get(result: dict[str, Any]) -> str:
     _append_warnings(lines, result.get("warnings"))
     return "\n".join(lines) + "\n"
 
+
+def _format_portal_list(result: dict[str, Any]) -> str:
+    data = result.get("data") if isinstance(result.get("data"), dict) else {}
+    items = data.get("items") if isinstance(data.get("items"), list) else []
+    rows: list[list[str]] = []
+    for item in items:
+        if not isinstance(item, dict):
+            continue
+        rows.append(
+            [
+                str(item.get("dash_key") or ""),
+                str(item.get("dash_name") or ""),
+                ",".join(str(tag_id) for tag_id in item.get("package_tag_ids") or []),
+            ]
+        )
+    text = _render_titled_table("Portals", ["dash_key", "name", "package_tag_ids"], rows).rstrip("\n")
+    lines = [text, f"Total: {data.get('total') if data.get('total') is not None else len(items)}"]
+    _append_warnings(lines, result.get("warnings"))
+    _append_verification(lines, result.get("verification"))
+    return "\n".join(lines) + "\n"
+
+
+def _format_portal_get(result: dict[str, Any]) -> str:
+    data = result.get("data") if isinstance(result.get("data"), dict) else {}
+    components = data.get("components") if isinstance(data.get("components"), list) else []
+    lines = [
+        f"Portal: {data.get('dash_name') or '-'}",
+        f"Dash Key: {data.get('dash_key') or '-'}",
+        f"Components: {data.get('component_count') if data.get('component_count') is not None else len(components)}",
+    ]
+    package_tag_ids = data.get("package_tag_ids") if isinstance(data.get("package_tag_ids"), list) else []
+    if package_tag_ids:
+        lines.append("Package Tag IDs: " + ", ".join(str(item) for item in package_tag_ids))
+    if components:
+        lines.append("Component Refs:")
+        for item in components[:12]:
+            if not isinstance(item, dict):
+                continue
+            prefix = f"- {item.get('source_type') or 'unknown'}"
+            title = item.get("title")
+            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 {}
+            if chart_ref:
+                lines.append(f"{prefix}: {title or chart_ref.get('chart_name') or '-'} / chart_id={chart_ref.get('chart_id') or '-'}")
+            elif view_ref:
+                lines.append(
+                    f"{prefix}: {title or view_ref.get('view_name') or '-'} / "
+                    f"view_id={view_ref.get('view_id') or '-'} / app_key={view_ref.get('app_key') or '-'}"
+                )
+            else:
+                lines.append(f"{prefix}: {title or '-'}")
+        if len(components) > 12:
+            lines.append(f"... {len(components) - 12} more")
+    _append_warnings(lines, result.get("warnings"))
+    _append_verification(lines, result.get("verification"))
+    return "\n".join(lines) + "\n"
+
+
+def _format_view_get(result: dict[str, Any]) -> str:
+    data = result.get("data") if isinstance(result.get("data"), dict) else {}
+    export_capability = data.get("export_capability") if isinstance(data.get("export_capability"), dict) else {}
+    visible_columns = data.get("visible_columns") if isinstance(data.get("visible_columns"), list) else []
+    lines = [
+        f"View: {data.get('view_name') or '-'}",
+        f"View ID: {data.get('view_id') or '-'}",
+        f"View Key: {data.get('view_key') or '-'}",
+        f"App Key: {data.get('app_key') or '-'}",
+        f"View Type: {data.get('view_type') or '-'}",
+        f"Analysis Supported: {data.get('analysis_supported')}",
+    ]
+    if export_capability:
+        lines.append(
+            "Export: "
+            f"supported={export_capability.get('supported')} / "
+            f"tool={export_capability.get('tool') or '-'} / "
+            f"requires_app_key={export_capability.get('requires_app_key')}"
+        )
+    lines.append(f"Visible Columns: {len(visible_columns)}")
+    for column in visible_columns[:20]:
+        lines.append(f"- {column}")
+    if len(visible_columns) > 20:
+        lines.append(f"... {len(visible_columns) - 20} more")
+    _append_warnings(lines, result.get("warnings"))
+    _append_verification(lines, result.get("verification"))
+    return "\n".join(lines) + "\n"
+
+
+def _format_chart_get(result: dict[str, Any]) -> str:
+    data = result.get("data") if isinstance(result.get("data"), dict) else {}
+    chart_data = data.get("data") if isinstance(data.get("data"), dict) else {}
+    config = data.get("config") if isinstance(data.get("config"), dict) else {}
+    lines = [
+        f"Chart: {data.get('chart_name') or '-'}",
+        f"Chart ID: {data.get('chart_id') or '-'}",
+        f"Chart Type: {data.get('chart_type') or '-'}",
+        f"Data Source: {data.get('data_source_type') or '-'} / {data.get('data_source_id') or '-'}",
+        f"Data Loaded: {bool(chart_data)}",
+        f"Config Loaded: {bool(config)}",
+    ]
+    summary = chart_data.get("summary") if isinstance(chart_data.get("summary"), dict) else {}
+    rows = chart_data.get("rows") if isinstance(chart_data.get("rows"), list) else []
+    if summary:
+        lines.append("Summary:")
+        lines.extend(f"- {line}" for line in _dict_scalar_lines(summary))
+    if rows:
+        lines.append(f"Rows: {len(rows)}")
+        lines.append(json.dumps(rows[0], ensure_ascii=False))
+    elif config:
+        lines.append("Config Keys: " + ", ".join(str(key) for key in list(config.keys())[:12]))
+    _append_warnings(lines, result.get("warnings"))
+    _append_verification(lines, result.get("verification"))
+    return "\n".join(lines) + "\n"
+
+
 def _format_record_list(result: dict[str, Any]) -> str:
     data = result.get("data") if isinstance(result.get("data"), dict) else {}
     items = data.get("items") if isinstance(data.get("items"), list) else []
@@ -281,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 {}
@@ -1153,8 +1324,13 @@ _FORMATTERS = {
     "workspace_select": _format_workspace_select,
     "app_list": _format_app_items,
     "app_get": _format_app_get,
+    "portal_list": _format_portal_list,
+    "portal_get": _format_portal_get,
+    "view_get": _format_view_get,
+    "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,