Ai 1343 Add Data App tools

TOOLS.md

@@ -43,6 +43,13 @@ filtering.
 ### OAuth Tools
 - [create_oauth_url](#create_oauth_url): Generates an OAuth authorization URL for a Keboola component configuration.
 
+### Other Tools
+- [get_data_apps](#get_data_apps): Lists summaries of data apps in the project given the limit and offset or gets details of a data apps by
+providing its configuration IDs.
+- [manage_data_app](#manage_data_app): Deploys a data app or stops running data app in the Keboola workspace integration given the action and config
+id.
+- [modify_data_app](#modify_data_app): Creates or updates a Streamlit data app in Keboola workspace integration.
+
 ### Project Tools
 - [get_project_info](#get_project_info): Return structured project information pulled from multiple endpoints.
 
@@ -869,6 +876,168 @@ EXAMPLES:
 
 ---
 
+# Other Tools
+<a name="get_data_apps"></a>
+## get_data_apps
+**Annotations**: `read-only`
+
+**Tags**: `data-app`
+
+**Description**:
+
+Lists summaries of data apps in the project given the limit and offset or gets details of a data apps by
+providing its configuration IDs.
+
+Considerations:
+- If configuration_ids are provided, the tool will return details of the data apps by their configuration IDs.
+- If no configuration_ids are provided, the tool will list all data apps in the project given the limit and offset.
+- Data App details contain configurations, deployment info along with logs and links to the data app dashboard.
+
+
+**Input JSON Schema**:
+```json
+{
+  "properties": {
+    "configuration_ids": {
+      "default": [],
+      "description": "The IDs of the data app configurations.",
+      "items": {
+        "type": "string"
+      },
+      "title": "Configuration Ids",
+      "type": "array"
+    },
+    "limit": {
+      "default": 100,
+      "description": "The limit of the data apps to fetch.",
+      "title": "Limit",
+      "type": "integer"
+    },
+    "offset": {
+      "default": 0,
+      "description": "The offset of the data apps to fetch.",
+      "title": "Offset",
+      "type": "integer"
+    }
+  },
+  "type": "object"
+}
+```
+
+---
+<a name="manage_data_app"></a>
+## manage_data_app
+**Annotations**: 
+
+**Tags**: `data-app`
+
+**Description**:
+
+Deploys a data app or stops running data app in the Keboola workspace integration given the action and config
+id.
+
+
+**Input JSON Schema**:
+```json
+{
+  "properties": {
+    "action": {
+      "description": "The action to perform.",
+      "enum": [
+        "deploy",
+        "stop"
+      ],
+      "title": "Action",
+      "type": "string"
+    },
+    "configuration_id": {
+      "description": "The ID of the data app configuration.",
+      "title": "Configuration Id",
+      "type": "string"
+    }
+  },
+  "required": [
+    "action",
+    "configuration_id"
+  ],
+  "type": "object"
+}
+```
+
+---
+<a name="modify_data_app"></a>
+## modify_data_app
+**Annotations**: `destructive`
+
+**Tags**: `data-app`
+
+**Description**:
+
+Creates or updates a Streamlit data app in Keboola workspace integration.
+
+Considerations:
+- The `source_code` parameter must be a complete and runnable Streamlit app. It must include a placeholder
+`{QUERY_DATA_FUNCTION}` where a `query_data` function will be injected. This function accepts a string of SQL
+query following current sql dialect and returns a pandas DataFrame with the results from the workspace.
+- Write SQL queries so they are compatible with the current workspace backend, you can ensure this by using the
+`query_data` tool to inspect the data in the workspace before using it in the data app.
+- If you're updating an existing data app, provide the `configuration_id` parameter. In this case, all existing
+parameters must either be preserved or explicitly updated. If the data app is deployed, it needs to be redeployed
+to apply the changes.
+
+
+**Input JSON Schema**:
+```json
+{
+  "properties": {
+    "name": {
+      "description": "Name of the data app.",
+      "title": "Name",
+      "type": "string"
+    },
+    "description": {
+      "description": "Description of the data app.",
+      "title": "Description",
+      "type": "string"
+    },
+    "source_code": {
+      "description": "Complete Python/Streamlit source code for the data app.",
+      "title": "Source Code",
+      "type": "string"
+    },
+    "packages": {
+      "description": "Python packages used in the source code necessary to be installed.",
+      "items": {
+        "type": "string"
+      },
+      "title": "Packages",
+      "type": "array"
+    },
+    "authorization_required": {
+      "default": false,
+      "description": "Whether the data app is authorized using simple password or not.",
+      "title": "Authorization Required",
+      "type": "boolean"
+    },
+    "configuration_id": {
+      "default": "",
+      "description": "The ID of existing data app configuration when updating, otherwise empty string.",
+      "title": "Configuration Id",
+      "type": "string"
+    }
+  },
+  "required": [
+    "name",
+    "description",
+    "source_code",
+    "packages"
+  ],
+  "type": "object"
+}
+```
+
+---
+
 # Documentation Tools
 <a name="docs_query"></a>
 ## docs_query

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "keboola-mcp-server"
-version = "1.18.1"
+version = "1.19.0"
 description = "MCP server for interacting with Keboola Connection"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -17,6 +17,7 @@ dependencies = [
     "jsonschema ~= 4.23",
     "pyjwt ~= 2.10",
     "json-log-formatter ~= 1.0",
+    "cryptography ~= 45.0",
 ]
 [project.optional-dependencies]
 codestyle = [

src/keboola_mcp_server/links.py

@@ -2,7 +2,11 @@
 
 from pydantic import BaseModel, ConfigDict, Field
 
-from keboola_mcp_server.clients.client import CONDITIONAL_FLOW_COMPONENT_ID, FlowType, KeboolaClient
+from keboola_mcp_server.clients.client import (
+    CONDITIONAL_FLOW_COMPONENT_ID,
+    FlowType,
+    KeboolaClient,
+)
 
 URLType = Literal['ui-detail', 'ui-dashboard', 'docs']
 
@@ -95,6 +99,40 @@ def get_configuration_links(self, component_id: str, configuration_id: str, conf
             self.get_config_dashboard_link(component_id=component_id, component_name=component_id),
         ]
 
+    # --- Data Apps ---
+    def get_data_app_config_link(self, configuration_id: str, configuration_name: str, is_authorized: bool) -> Link:
+        title = (
+            f'Data App Configuration (To see password, click on "OPEN DATA APP"): {configuration_name}'
+            if is_authorized
+            else f'Data App Configuration: {configuration_name}'
+        )
+        return Link.detail(title=title, url=self._url(f'data-apps/{configuration_id}'))
+
+    def get_data_app_dashboard_link(self) -> Link:
+        return Link.dashboard(title='Data Apps in the project', url=self._url('data-apps'))
+
+    def get_data_app_deployment_link(self, deployment_link: str) -> Link:
+        return Link.detail(title='Data App Deployment', url=deployment_link)
+
+    def get_data_app_links(
+        self,
+        configuration_id: str,
+        configuration_name: str,
+        deployment_link: str | None = None,
+        is_authorized: bool = False,
+    ) -> list[Link]:
+        links = [
+            self.get_data_app_config_link(
+                configuration_id=configuration_id,
+                configuration_name=configuration_name,
+                is_authorized=is_authorized,
+            ),
+            self.get_data_app_dashboard_link(),
+        ]
+        if deployment_link:
+            links.append(self.get_data_app_deployment_link(deployment_link))
+        return links
+
     # --- Transformations ---
     def get_transformations_dashboard_link(self) -> Link:
         return Link.dashboard(title='Transformations dashboard', url=self._url('transformations-v2'))

src/keboola_mcp_server/server.py

@@ -20,6 +20,7 @@
 from keboola_mcp_server.oauth import SimpleOAuthProvider
 from keboola_mcp_server.prompts.add_prompts import add_keboola_prompts
 from keboola_mcp_server.tools.components import add_component_tools
+from keboola_mcp_server.tools.data_apps import add_data_app_tools
 from keboola_mcp_server.tools.doc import add_doc_tools
 from keboola_mcp_server.tools.flow.tools import add_flow_tools
 from keboola_mcp_server.tools.jobs import add_job_tools
@@ -215,6 +216,7 @@ def create_server(
         custom_routes.add_to_mcp(mcp)
 
     add_component_tools(mcp)
+    add_data_app_tools(mcp)
     add_doc_tools(mcp)
     add_flow_tools(mcp)
     add_job_tools(mcp)