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

package/README.md

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

package/package.json

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

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

@@ -20,7 +20,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     file_upload_local.add_argument("--bucket-type")
     file_upload_local.add_argument("--path-id", type=int)
     file_upload_local.add_argument("--file-related-url")
-    file_upload_local.set_defaults(handler=_handle_file_upload_local, format_hint="generic")
+    file_upload_local.set_defaults(handler=_handle_file_upload_local, format_hint="file_upload_local")
 
     feedback = builder_subparsers.add_parser("feedback", help="builder 侧反馈提交")
     feedback_subparsers = feedback.add_subparsers(dest="builder_feedback_command", required=True)

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/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 []
@@ -926,6 +1040,47 @@ def _format_builder_summary(result: dict[str, Any]) -> str:
     return "\n".join(lines) + "\n"
 
 
+def _format_file_upload_local(result: dict[str, Any]) -> str:
+    lines = [
+        f"Upload Kind: {result.get('upload_kind') or result.get('requested_upload_kind') or '-'}",
+        f"Effective Upload Kind: {result.get('effective_upload_kind') or result.get('upload_kind') or '-'}",
+    ]
+    if "upload_fallback_applied" in result:
+        lines.append(f"Fallback Applied: {result.get('upload_fallback_applied')}")
+    if result.get("upload_fallback_reason"):
+        lines.append(f"Fallback Reason: {result.get('upload_fallback_reason')}")
+    if result.get("file_name"):
+        lines.append(f"File: {result.get('file_name')}")
+    if result.get("file_size") is not None:
+        lines.append(f"Size: {result.get('file_size')}")
+    if result.get("content_type"):
+        lines.append(f"Content Type: {result.get('content_type')}")
+    if result.get("upload_protocol"):
+        lines.append(f"Protocol: {result.get('upload_protocol')}")
+    if result.get("download_url"):
+        lines.append(f"Download URL: {result.get('download_url')}")
+
+    attachment_value = result.get("attachment_value") if isinstance(result.get("attachment_value"), dict) else {}
+    if attachment_value:
+        lines.append("Attachment Value:")
+        for key in ("value", "name", "otherInfo"):
+            value = attachment_value.get(key)
+            if value not in (None, ""):
+                lines.append(f"- {key}: {value}")
+
+    comment_file_info = result.get("comment_file_info") if isinstance(result.get("comment_file_info"), dict) else {}
+    if comment_file_info:
+        lines.append("Comment File:")
+        for key in ("url", "name", "uploadFileSize"):
+            value = comment_file_info.get(key)
+            if value not in (None, ""):
+                lines.append(f"- {key}: {value}")
+
+    _append_warnings(lines, result.get("warnings"))
+    _append_verification(lines, result.get("verification"))
+    return "\n".join(lines) + "\n"
+
+
 def emit_json_result(result: dict[str, Any], *, stream: TextIO) -> None:
     json.dump(result, stream, ensure_ascii=False, indent=2)
     stream.write("\n")
@@ -1112,6 +1267,10 @@ _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_get": _format_record_get,
@@ -1135,4 +1294,5 @@ _FORMATTERS = {
     "export_get": _format_export_get,
     "export_direct": _format_export_direct,
     "builder_summary": _format_builder_summary,
+    "file_upload_local": _format_file_upload_local,
 }