atlan-application-sdk 0.1.1rc44__tar.gz → 0.1.1rc46__tar.gz

atlan_application_sdk-0.1.1rc46/.github/release_notes.md

@@ -0,0 +1,7 @@
+## v0.1.1rc46 (September 18, 2025)
+
+Full Changelog: https://github.com/atlanhq/application-sdk/compare/v0.1.1rc45...v0.1.1rc46
+
+### Bug Fixes
+
+- Fix semaphore implementation to allow multiple batching without getting into max_concurrent_activities issue (#725) (by @Mustafa in [2a66f13](https://github.com/atlanhq/application-sdk/commit/2a66f13))

{atlan_application_sdk-0.1.1rc44 → atlan_application_sdk-0.1.1rc46}/CHANGELOG.md

@@ -1,6 +1,26 @@
 # Changelog
 
 
+## v0.1.1rc46 (September 18, 2025)
+
+Full Changelog: https://github.com/atlanhq/application-sdk/compare/v0.1.1rc45...v0.1.1rc46
+
+### Bug Fixes
+
+- Fix semaphore implementation to allow multiple batching without getting into max_concurrent_activities issue (#725) (by @Mustafa in [2a66f13](https://github.com/atlanhq/application-sdk/commit/2a66f13))
+
+## v0.1.1rc45 (September 18, 2025)
+
+Full Changelog: https://github.com/atlanhq/application-sdk/compare/v0.1.1rc44...v0.1.1rc45
+
+### Features
+
+- add MCP (Model Context Protocol) integration to application-sdk (#698) (by @AdvitXAtlan in [a5d496e](https://github.com/atlanhq/application-sdk/commit/a5d496e))
+- fix credentials and extra field information in docs (#724) (by @Nishchith Shetty in [a0808db](https://github.com/atlanhq/application-sdk/commit/a0808db))
+- add minimal API docs for endpoints exposed (#721) (by @Nishchith Shetty in [3301b61](https://github.com/atlanhq/application-sdk/commit/3301b61))
+
+
+
 ## v0.1.1rc44 (September 17, 2025)
 
 Full Changelog: https://github.com/atlanhq/application-sdk/compare/v0.1.1rc43...v0.1.1rc44

{atlan_application_sdk-0.1.1rc44 → atlan_application_sdk-0.1.1rc46}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atlan-application-sdk
-Version: 0.1.1rc44
+Version: 0.1.1rc46
 Summary: Atlan Application SDK is a Python library for developing applications on the Atlan Platform
 Project-URL: Repository, https://github.com/atlanhq/application-sdk
 Project-URL: Documentation, https://github.com/atlanhq/application-sdk/README.md

{atlan_application_sdk-0.1.1rc44 → atlan_application_sdk-0.1.1rc46}/application_sdk/activities/lock_management.py

@@ -5,15 +5,15 @@ allowing the workflow to orchestrate locking without hitting Temporal's
 deadlock timeout.
 """
 
-import asyncio
 import random
 from typing import Any, Dict
 
 from temporalio import activity
+from temporalio.exceptions import ApplicationError
 
 from application_sdk.clients.redis import RedisClientAsync
 from application_sdk.common.error_codes import ActivityError
-from application_sdk.constants import APPLICATION_NAME, LOCK_RETRY_INTERVAL
+from application_sdk.constants import APPLICATION_NAME
 from application_sdk.observability.logger_adaptor import get_logger
 
 logger = get_logger(__name__)
@@ -45,40 +45,41 @@ async def acquire_distributed_lock(
     """
     # Input validation
     if max_locks <= 0:
-        raise ActivityError(
-            f"{ActivityError.LOCK_ACQUISITION_ERROR}: max_locks must be greater than 0, got {max_locks}"
+        raise ApplicationError(
+            f"{ActivityError.LOCK_ACQUISITION_ERROR}: max_locks must be greater than 0, got {max_locks}",
+            non_retryable=True,
+        )
+    slot = random.randint(0, max_locks - 1)
+    resource_id = f"{APPLICATION_NAME}:{lock_name}:{slot}"
+
+    try:
+        async with RedisClientAsync() as redis_client:
+            # Acquire lock - connection will stay open until context exits
+            acquired = await redis_client._acquire_lock(
+                resource_id, owner_id, ttl_seconds
+            )
+            if acquired:
+                logger.info(f"Lock acquired for slot {slot}, resource: {resource_id}")
+                return {
+                    "status": True,
+                    "slot_id": slot,
+                    "resource_id": resource_id,
+                    "owner_id": owner_id,
+                }
+
+            raise ActivityError(
+                f"{ActivityError.LOCK_ACQUISITION_ERROR}: Lock not acquired for {resource_id}, will retry after some time"
+            )
+    except Exception as e:
+        # Redis connection or operation failed - propagate as activity error
+        if isinstance(e, (ActivityError)):
+            raise e
+        logger.error(f"Redis error during lock acquisition: {e}")
+        raise ApplicationError(
+            f"Redis error during lock acquisition for {resource_id}, error: {e}",
+            non_retryable=True,
+            type=type(e).__name__,
         )
-
-    async with RedisClientAsync() as redis_client:
-        while True:
-            slot = random.randint(0, max_locks - 1)
-            resource_id = f"{APPLICATION_NAME}:{lock_name}:{slot}"
-
-            try:
-                # Acquire lock - connection will stay open until context exits
-                acquired = await redis_client._acquire_lock(
-                    resource_id, owner_id, ttl_seconds
-                )
-                if acquired:
-                    logger.info(
-                        f"Lock acquired for slot {slot}, resource: {resource_id}"
-                    )
-                    return {
-                        "slot_id": slot,
-                        "resource_id": resource_id,
-                        "owner_id": owner_id,
-                    }
-                # If not acquired, continue retrying (lock held by another owner)
-
-            except Exception as e:
-                # Redis connection or operation failed - propagate as activity error
-                logger.error(f"Redis error during lock acquisition: {e}")
-                raise ActivityError(
-                    f"{ActivityError.LOCK_ACQUISITION_ERROR}: Redis error during lock acquisition for {resource_id}"
-                )
-
-            # Wait before retrying
-            await asyncio.sleep(LOCK_RETRY_INTERVAL)
 
 
 @activity.defn
@@ -94,8 +95,8 @@ async def release_distributed_lock(
     Returns:
         True if lock was released successfully, False otherwise
     """
-    async with RedisClientAsync() as redis_client:
-        try:
+    try:
+        async with RedisClientAsync() as redis_client:
             released, result = await redis_client._release_lock(resource_id, owner_id)
             if released:
                 logger.info(
@@ -103,8 +104,8 @@ async def release_distributed_lock(
                 )
             return released
 
-        except Exception as e:
-            logger.error(f"Redis error during lock release for {resource_id}: {e}")
-            # Don't raise exception for lock release failures - log and return False
-            # Lock release is best-effort and shouldn't fail the workflow
-            return False
+    except Exception as e:
+        logger.error(f"Redis error during lock release for {resource_id}: {e}")
+        # Don't raise exception for lock release failures - log and return False
+        # Lock release is best-effort and shouldn't fail the workflow
+        return False

{atlan_application_sdk-0.1.1rc44 → atlan_application_sdk-0.1.1rc46}/application_sdk/application/__init__.py

@@ -4,6 +4,7 @@ from typing import Any, Dict, List, Optional, Tuple, Type
 from application_sdk.activities import ActivitiesInterface
 from application_sdk.clients.base import BaseClient
 from application_sdk.clients.utils import get_workflow_client
+from application_sdk.constants import ENABLE_MCP
 from application_sdk.events.models import EventRegistration
 from application_sdk.handlers.base import BaseHandler
 from application_sdk.observability.logger_adaptor import get_logger
@@ -29,7 +30,7 @@ class BaseApplication:
         self,
         name: str,
         server: Optional[ServerInterface] = None,
-        application_manifest: Optional[dict] = None,
+        application_manifest: Optional[Dict[str, Any]] = None,
         client_class: Optional[Type[BaseClient]] = None,
         handler_class: Optional[Type[BaseHandler]] = None,
     ):
@@ -39,6 +40,9 @@ class BaseApplication:
         Args:
             name (str): The name of the application.
             server (ServerInterface): The server class for the application.
+            application_manifest (Optional[Dict[str, Any]]): Application manifest configuration.
+            client_class (Optional[Type[BaseClient]]): Client class for the application.
+            handler_class (Optional[Type[BaseHandler]]): Handler class for the application.
         """
         self.application_name = name
 
@@ -49,14 +53,21 @@ class BaseApplication:
 
         self.workflow_client = get_workflow_client(application_name=name)
 
-        self.application_manifest: Dict[str, Any] = application_manifest
+        self.application_manifest: Optional[Dict[str, Any]] = application_manifest
         self.bootstrap_event_registration()
 
         self.client_class = client_class or BaseClient
         self.handler_class = handler_class or BaseHandler
 
+        # MCP configuration
+        self.mcp_server: Optional["MCPServer"] = None
+        if ENABLE_MCP:
+            from application_sdk.server.mcp import MCPServer
+
+            self.mcp_server = MCPServer(application_name=name)
+
     def bootstrap_event_registration(self):
-        self.event_subscriptions = {}
+        self.event_subscriptions: Dict[str, EventWorkflowTrigger] = {}
         if self.application_manifest is None:
             logger.warning("No application manifest found, skipping event registration")
             return
@@ -122,8 +133,8 @@ class BaseApplication:
         ]
         workflow_activities = []
         for workflow_class, activities_class in workflow_and_activities_classes:
-            workflow_activities.extend(
-                workflow_class.get_activities(activities_class())
+            workflow_activities.extend(  # type: ignore
+                workflow_class.get_activities(activities_class())  # type: ignore
             )
 
         self.worker = Worker(
@@ -134,6 +145,13 @@ class BaseApplication:
             activity_executor=activity_executor,
         )
 
+        # Register MCP tools if ENABLED_MCP is True and an MCP server is initialized
+        if self.mcp_server:
+            logger.info("Registering MCP tools from workflow and activities classes")
+            await self.mcp_server.register_tools(  # type: ignore
+                workflow_and_activities_classes=workflow_and_activities_classes
+            )
+
     async def start_workflow(self, workflow_args, workflow_class) -> Any:
         """
         Start a new workflow execution.
@@ -147,7 +165,7 @@ class BaseApplication:
         """
         if self.workflow_client is None:
             raise ValueError("Workflow client not initialized")
-        return await self.workflow_client.start_workflow(workflow_args, workflow_class)
+        return await self.workflow_client.start_workflow(workflow_args, workflow_class)  # type: ignore
 
     async def start_worker(self, daemon: bool = True):
         """
@@ -162,39 +180,61 @@ class BaseApplication:
 
     async def setup_server(
         self,
-        workflow_class,
+        workflow_class: Type[WorkflowInterface],
         ui_enabled: bool = True,
         has_configmap: bool = False,
     ):
         """
-        Optionally set up a server for the application. (No-op by default)
+        Set up FastAPI server and automatically mount MCP if enabled.
+
+        Args:
+            workflow_class (WorkflowInterface): The workflow class for the application.
+            ui_enabled (bool): Whether to enable the UI.
+            has_configmap (bool): Whether to enable the configmap.
         """
         if self.workflow_client is None:
             await self.workflow_client.load()
 
-        # Overrides the application server. serves the UI, and handles the various triggers
+        mcp_http_app: Optional[Any] = None
+        lifespan: Optional[Any] = None
+
+        if self.mcp_server:
+            try:
+                mcp_http_app = await self.mcp_server.get_http_app()
+                lifespan = mcp_http_app.lifespan
+            except Exception as e:
+                logger.warning(f"Failed to get MCP HTTP app: {e}")
+
         self.server = APIServer(
+            lifespan=lifespan,
             workflow_client=self.workflow_client,
             ui_enabled=ui_enabled,
             handler=self.handler_class(client=self.client_class()),
             has_configmap=has_configmap,
         )
 
+        # Mount MCP at root
+        if mcp_http_app:
+            try:
+                self.server.app.mount("", mcp_http_app)  # Mount at root
+            except Exception as e:
+                logger.warning(f"Failed to mount MCP HTTP app: {e}")
+
+        # Register event-based workflows if any
         if self.event_subscriptions:
             for event_trigger in self.event_subscriptions.values():
-                if event_trigger.workflow_class is None:
+                if event_trigger.workflow_class is None:  # type: ignore
                     raise ValueError(
                         f"Workflow class not set for event trigger {event_trigger.event_id}"
                     )
 
-                self.server.register_workflow(
-                    workflow_class=event_trigger.workflow_class,
+                self.server.register_workflow(  # type: ignore
+                    workflow_class=event_trigger.workflow_class,  # type: ignore
                     triggers=[event_trigger],
                 )
 
-        # register the workflow on the application server
-        # the workflow is by default triggered by an HTTP POST request to the /start endpoint
-        self.server.register_workflow(
+        # Register the main workflow (HTTP POST /start endpoint)
+        self.server.register_workflow(  # type: ignore
             workflow_class=workflow_class,
             triggers=[HttpWorkflowTrigger()],
         )

{atlan_application_sdk-0.1.1rc44 → atlan_application_sdk-0.1.1rc46}/application_sdk/constants.py

@@ -255,3 +255,9 @@ REDIS_SENTINEL_HOSTS = os.getenv("REDIS_SENTINEL_HOSTS", "")
 IS_LOCKING_DISABLED = os.getenv("IS_LOCKING_DISABLED", "true").lower() == "true"
 #: Retry interval for lock acquisition
 LOCK_RETRY_INTERVAL = int(os.getenv("LOCK_RETRY_INTERVAL", "5"))
+
+# MCP Configuration
+#: Flag to indicate if MCP should be enabled or not. Turning this to true will setup an MCP server along
+#: with the application.
+ENABLE_MCP = os.getenv("ENABLE_MCP", "false").lower() == "true"
+MCP_METADATA_KEY = "__atlan_application_sdk_mcp_metadata"

atlan_application_sdk-0.1.1rc46/application_sdk/decorators/mcp_tool.py

@@ -0,0 +1,63 @@
+"""
+MCP tool decorator for marking activities as MCP tools.
+
+This module provides the @mcp_tool decorator that developers use to mark
+activities for automatic exposure via Model Context Protocol.
+"""
+
+from typing import Any, Callable, Optional
+
+from application_sdk.constants import MCP_METADATA_KEY
+from application_sdk.server.mcp import MCPMetadata
+
+
+def mcp_tool(
+    name: Optional[str] = None,
+    description: Optional[str] = None,
+    visible: bool = True,
+    *args,
+    **kwargs,
+):
+    """
+    Decorator to mark functions as MCP tools.
+
+    Use this decorator to mark any function as an MCP tool. You can additionally use the `visible`
+    parameter to control whether the tool is visible at runtime or not.
+
+    Function parameters that are Pydantic models will be automatically converted into correct JSON schema
+    for the tool specification. This is handled by the underlying FastMCP server implementation.
+
+    Args:
+        name(Optional[str]): The name of the tool. Defaults to the function name.
+        description(Optional[str]): The description of the tool. Defaults to the function docstring.
+        visible(bool): Whether the MCP tool is visible at runtime or not. Defaults to True.
+        *args: Additional arguments to pass to the tool.
+        **kwargs: Additional keyword arguments to pass to the tool.
+
+    Examples:
+        >>> @mcp_tool(name="add_numbers", description="Add two numbers", visible=True)
+        >>> def add_numbers(self, a: int, b: int) -> int:
+        >>>     return a + b
+
+
+        >>> # Use with Temporal activity decorator
+        >>> @activity.defn
+        >>> @mcp_tool(name="get_weather", description="Get the weather for a given city")
+        >>> async def get_weather(self, city: str) -> str:
+        >>>     # ... activity implementation unchanged ...
+    """
+
+    def decorator(f: Callable[..., Any]) -> Callable[..., Any]:
+        mcp_metadata = MCPMetadata(
+            name=name if name else f.__name__,
+            description=description if description else f.__doc__,
+            visible=visible,
+            args=args,
+            kwargs=kwargs,
+        )
+
+        setattr(f, MCP_METADATA_KEY, mcp_metadata)
+
+        return f
+
+    return decorator

{atlan_application_sdk-0.1.1rc44 → atlan_application_sdk-0.1.1rc46}/application_sdk/interceptors/lock.py

@@ -22,6 +22,7 @@ from application_sdk.constants import (
     APPLICATION_NAME,
     IS_LOCKING_DISABLED,
     LOCK_METADATA_KEY,
+    LOCK_RETRY_INTERVAL,
 )
 from application_sdk.observability.logger_adaptor import get_logger
 
@@ -106,13 +107,17 @@ class RedisLockOutboundInterceptor(WorkflowOutboundInterceptor):
         lock_result = None
 
         try:
-            # Step 1: Acquire lock via dedicated activity (can take >2s safely)
-            start_to_close_timeout = workflow.info().execution_timeout
-            lock_result = await workflow.execute_activity(
+            # Step 1: Acquire lock via dedicated activity with Temporal retry policy
+            schedule_to_close_timeout = workflow.info().execution_timeout
+            lock_result = await workflow.execute_local_activity(
                 "acquire_distributed_lock",
                 args=[lock_name, max_locks, ttl_seconds, owner_id],
-                start_to_close_timeout=start_to_close_timeout,
-                retry_policy=RetryPolicy(maximum_attempts=1),
+                start_to_close_timeout=timedelta(seconds=30),
+                retry_policy=RetryPolicy(
+                    initial_interval=timedelta(seconds=int(LOCK_RETRY_INTERVAL)),
+                    backoff_coefficient=1.0,
+                ),
+                schedule_to_close_timeout=schedule_to_close_timeout,
             )
 
             logger.debug(f"Lock acquired: {lock_result}, executing {input.activity}")

atlan_application_sdk-0.1.1rc46/application_sdk/server/mcp/__init__.py

@@ -0,0 +1,4 @@
+from application_sdk.server.mcp.models import MCPMetadata
+from application_sdk.server.mcp.server import MCPServer
+
+__all__ = ["MCPServer", "MCPMetadata"]

atlan_application_sdk-0.1.1rc46/application_sdk/server/mcp/models.py

@@ -0,0 +1,11 @@
+from typing import Any, Dict, Optional, Tuple
+
+from pydantic import BaseModel
+
+
+class MCPMetadata(BaseModel):
+    name: str
+    description: Optional[str]
+    visible: bool
+    args: Tuple[Any, ...] = ()
+    kwargs: Dict[str, Any] = {}

atlan_application_sdk-0.1.1rc46/application_sdk/server/mcp/server.py

@@ -0,0 +1,96 @@
+"""
+MCP Server implementation using FastMCP for Atlan Application SDK.
+
+This module provides the MCPServer class that automatically discovers
+activities marked with @mcp_tool decorators and mounts them on FastAPI
+using streamable HTTP transport.
+"""
+
+from typing import Any, Callable, List, Optional, Tuple, Type
+
+from fastmcp import FastMCP
+from fastmcp.server.http import StarletteWithLifespan
+
+from application_sdk.activities import ActivitiesInterface
+from application_sdk.constants import MCP_METADATA_KEY
+from application_sdk.observability.logger_adaptor import get_logger
+from application_sdk.server.mcp.models import MCPMetadata
+from application_sdk.workflows import WorkflowInterface
+
+
+class MCPServer:
+    """
+    MCP Server using FastMCP 2.0 with FastAPI mounting capability.
+
+    This server automatically discovers activities marked with @mcp_tool
+    and creates a FastMCP server that can be mounted on FastAPI.
+    """
+
+    def __init__(self, application_name: str, instructions: Optional[str] = None):
+        """
+        Initialize the MCP server.
+
+        Args:
+            application_name (str): Name of the application
+            instructions (Optional[str]): Description for the MCP server
+        """
+        self.application_name = application_name
+
+        self.logger = get_logger(__name__)
+
+        # FastMCP Server
+        self.server = FastMCP(
+            name=f"{application_name} MCP",
+            instructions=instructions,
+            on_duplicate_tools="error",
+        )
+
+    async def register_tools(
+        self,
+        workflow_and_activities_classes: List[
+            Tuple[Type[WorkflowInterface], Type[ActivitiesInterface]]
+        ],
+    ) -> None:
+        """
+        Discover activities marked with @mcp_tool and register them.
+
+        Args:
+            workflow_and_activities_classes: List of (workflow_class, activities_class) tuples
+        """
+        activity_methods: List[Callable[..., Any]] = []
+        for workflow_class, activities_class in workflow_and_activities_classes:
+            activities_instance = activities_class()
+            activity_methods.extend(workflow_class.get_activities(activities_instance))  # type: ignore
+
+        for f in activity_methods:
+            mcp_metadata: Optional[MCPMetadata] = getattr(f, MCP_METADATA_KEY, None)
+            if not mcp_metadata:
+                self.logger.info(
+                    f"No MCP metadata found on activity method {f.__name__}. Skipping tool registration"
+                )
+                continue
+
+            if mcp_metadata.visible:
+                self.logger.info(
+                    f"Registering tool {mcp_metadata.name} with description: {mcp_metadata.description}"
+                )
+                self.server.tool(
+                    f,
+                    name=mcp_metadata.name,
+                    description=mcp_metadata.description,
+                    *mcp_metadata.args,
+                    **mcp_metadata.kwargs,
+                )
+            else:
+                self.logger.info(
+                    f"Tool {mcp_metadata.name} is marked as not visible. Skipping tool registration"
+                )
+
+        tools = await self.server.get_tools()
+        self.logger.info(f"Registered {len(tools)} tools: {list(tools.keys())}")
+
+    async def get_http_app(self) -> StarletteWithLifespan:
+        """
+        Get the HTTP app for the MCP server.
+        """
+        return self.server.http_app()

{atlan_application_sdk-0.1.1rc44 → atlan_application_sdk-0.1.1rc46}/application_sdk/version.py

@@ -2,4 +2,4 @@
 Version information for the application_sdk package.
 """
 
-__version__ = "0.1.1rc44"
+__version__ = "0.1.1rc46"