@josephyan/qingflow-mcp 0.1.0-beta.2

package/src/qingflow_mcp/tools/__init__.py

@@ -0,0 +1 @@
+from __future__ import annotations

package/src/qingflow_mcp/tools/app_tools.py

@@ -0,0 +1,239 @@
+from __future__ import annotations
+
+from mcp.server.fastmcp import FastMCP
+
+from ..config import DEFAULT_PROFILE
+from ..errors import QingflowApiError, raise_tool_error
+from ..json_types import JSONObject
+from .base import ToolBase
+
+
+class AppTools(ToolBase):
+    def register(self, mcp: FastMCP) -> None:
+        @mcp.tool()
+        def app_list(profile: str = DEFAULT_PROFILE, ship_auth: bool = False) -> JSONObject:
+            return self.app_list(profile=profile, ship_auth=ship_auth)
+
+        @mcp.tool()
+        def app_search(profile: str = DEFAULT_PROFILE, keyword: str = "", page_num: int = 1, page_size: int = 50) -> JSONObject:
+            return self.app_search(profile=profile, keyword=keyword, page_num=page_num, page_size=page_size)
+
+        @mcp.tool()
+        def app_get_base(profile: str = DEFAULT_PROFILE, app_key: str = "") -> JSONObject:
+            return self.app_get_base(profile=profile, app_key=app_key)
+
+        @mcp.tool(description=self._high_risk_tool_description(operation="update", target="app base settings"))
+        def app_update_base(profile: str = DEFAULT_PROFILE, app_key: str = "", payload: JSONObject | None = None) -> JSONObject:
+            return self.app_update_base(profile=profile, app_key=app_key, payload=payload or {})
+
+        @mcp.tool()
+        def app_get_form_schema(
+            profile: str = DEFAULT_PROFILE,
+            app_key: str = "",
+            form_type: int = 1,
+            being_draft: bool | None = None,
+            being_apply: bool | None = None,
+            audit_node_id: int | None = None,
+        ) -> JSONObject:
+            return self.app_get_form_schema(
+                profile=profile,
+                app_key=app_key,
+                form_type=form_type,
+                being_draft=being_draft,
+                being_apply=being_apply,
+                audit_node_id=audit_node_id,
+            )
+
+        @mcp.tool()
+        def app_get_edit_version_no(profile: str = DEFAULT_PROFILE, app_key: str = "") -> JSONObject:
+            return self.app_get_edit_version_no(profile=profile, app_key=app_key)
+
+        @mcp.tool(description=self._high_risk_tool_description(operation="update", target="app form schema"))
+        def app_update_form_schema(profile: str = DEFAULT_PROFILE, app_key: str = "", payload: JSONObject | None = None) -> JSONObject:
+            return self.app_update_form_schema(profile=profile, app_key=app_key, payload=payload or {})
+
+        @mcp.tool()
+        def app_edit_finished(profile: str = DEFAULT_PROFILE, app_key: str = "", payload: JSONObject | None = None) -> JSONObject:
+            return self.app_edit_finished(profile=profile, app_key=app_key, payload=payload or {})
+
+        @mcp.tool()
+        def app_create(profile: str = DEFAULT_PROFILE, payload: JSONObject | None = None) -> JSONObject:
+            return self.app_create(profile=profile, payload=payload or {})
+
+        @mcp.tool(description=self._high_risk_tool_description(operation="delete", target="app configuration"))
+        def app_delete(profile: str = DEFAULT_PROFILE, app_key: str = "") -> JSONObject:
+            return self.app_delete(profile=profile, app_key=app_key)
+
+        @mcp.tool()
+        def app_publish(
+            profile: str = DEFAULT_PROFILE,
+            app_key: str = "",
+            payload: JSONObject | None = None,
+        ) -> JSONObject:
+            return self.app_publish(profile=profile, app_key=app_key, payload=payload or {})
+
+    def app_list(self, *, profile: str, ship_auth: bool = False) -> JSONObject:
+        """Get all apps with full hierarchy from tag/apps endpoint."""
+        def runner(session_profile, context):
+            result = self.backend.request("GET", context, "/tag/apps")
+            return {
+                "profile": profile,
+                "ws_id": session_profile.selected_ws_id,
+                "items": result,
+            }
+
+        return self._run(profile, runner)
+
+    def app_search(self, *, profile: str, keyword: str = "", page_num: int = 1, page_size: int = 50) -> JSONObject:
+        """Search apps by keyword in name/title using backend search API.
+        Useful for finding BUG-related apps across all packages."""
+        def runner(session_profile, context):
+            # Use GET /app/item which supports queryKey search across all apps
+            params: JSONObject = {"pageNum": page_num, "pageSize": page_size}
+            if keyword:
+                params["queryKey"] = keyword
+            
+            result = self.backend.request("GET", context, "/app/item", params=params)
+            
+            # Extract app list from the response
+            apps = []
+            if isinstance(result, dict):
+                items = result.get("list", [])
+                for item in items:
+                    if isinstance(item, dict):
+                        apps.append({
+                            "app_key": item.get("appKey"),
+                            "title": item.get("title") or item.get("formTitle"),
+                            "form_id": item.get("formId"),
+                            "tag_id": item.get("tagId"),
+                            "group_id": item.get("groupId"),
+                        })
+            
+            return {
+                "profile": profile,
+                "ws_id": session_profile.selected_ws_id,
+                "keyword": keyword,
+                "page_num": page_num,
+                "page_size": page_size,
+                "total": result.get("total") if isinstance(result, dict) else len(apps),
+                "apps": apps,
+            }
+
+        return self._run(profile, runner)
+
+    def app_get_base(self, *, profile: str, app_key: str) -> JSONObject:
+        self._require_app_key(app_key)
+
+        def runner(session_profile, context):
+            result = self.backend.request("GET", context, f"/app/{app_key}/baseInfo")
+            return {"profile": profile, "ws_id": session_profile.selected_ws_id, "app_key": app_key, "result": result}
+
+        return self._run(profile, runner)
+
+    def app_update_base(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+
+        def runner(session_profile, context):
+            result = self.backend.request("POST", context, f"/app/{app_key}/baseInfo", json_body=body)
+            return self._attach_human_review_notice(
+                {"profile": profile, "ws_id": session_profile.selected_ws_id, "app_key": app_key, "result": result},
+                operation="update",
+                target="app base settings",
+            )
+
+        return self._run(profile, runner)
+
+    def app_get_form_schema(
+        self,
+        *,
+        profile: str,
+        app_key: str,
+        form_type: int,
+        being_draft: bool | None,
+        being_apply: bool | None,
+        audit_node_id: int | None,
+    ) -> JSONObject:
+        self._require_app_key(app_key)
+
+        def runner(session_profile, context):
+            params: JSONObject = {"type": form_type}
+            if being_draft is not None:
+                params["beingDraft"] = being_draft
+            if being_apply is not None:
+                params["beingApply"] = being_apply
+            if audit_node_id is not None:
+                params["auditNodeId"] = audit_node_id
+            result = self.backend.request("GET", context, f"/app/{app_key}/form", params=params)
+            return {"profile": profile, "ws_id": session_profile.selected_ws_id, "app_key": app_key, "result": result}
+
+        return self._run(profile, runner)
+
+    def app_get_edit_version_no(self, *, profile: str, app_key: str) -> JSONObject:
+        self._require_app_key(app_key)
+
+        def runner(session_profile, context):
+            result = self.backend.request("GET", context, f"/app/{app_key}/editVersionNo")
+            return {"profile": profile, "ws_id": session_profile.selected_ws_id, "app_key": app_key, "result": result}
+
+        return self._run(profile, runner)
+
+    def app_update_form_schema(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+
+        def runner(session_profile, context):
+            result = self.backend.request("POST", context, f"/app/{app_key}/form", json_body=body)
+            return self._attach_human_review_notice(
+                {"profile": profile, "ws_id": session_profile.selected_ws_id, "app_key": app_key, "result": result},
+                operation="update",
+                target="app form schema",
+            )
+
+        return self._run(profile, runner)
+
+    def app_edit_finished(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+
+        def runner(session_profile, context):
+            result = self.backend.request("POST", context, f"/app/{app_key}/editFinished", json_body=body)
+            return {"profile": profile, "ws_id": session_profile.selected_ws_id, "app_key": app_key, "result": result}
+
+        return self._run(profile, runner)
+
+    def app_create(self, *, profile: str, payload: JSONObject) -> JSONObject:
+        body = self._require_dict(payload)
+
+        def runner(session_profile, context):
+            result = self.backend.request("POST", context, "/app", json_body=body)
+            return {"profile": profile, "ws_id": session_profile.selected_ws_id, "result": result}
+
+        return self._run(profile, runner)
+
+    def app_delete(self, *, profile: str, app_key: str) -> JSONObject:
+        self._require_app_key(app_key)
+
+        def runner(session_profile, context):
+            result = self.backend.request("DELETE", context, f"/app/{app_key}")
+            return self._attach_human_review_notice(
+                {"profile": profile, "ws_id": session_profile.selected_ws_id, "app_key": app_key, "result": result},
+                operation="delete",
+                target="app configuration",
+            )
+
+        return self._run(profile, runner)
+
+    def app_publish(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+
+        def runner(session_profile, context):
+            result = self.backend.request("POST", context, f"/app/{app_key}/publish", json_body=body)
+            return {"profile": profile, "ws_id": session_profile.selected_ws_id, "app_key": app_key, "result": result}
+
+        return self._run(profile, runner)
+
+    def _require_app_key(self, app_key: str) -> None:
+        if not app_key:
+            raise_tool_error(QingflowApiError.config_error("app_key is required"))