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

atlan_application_sdk-0.1.1rc45/.github/release_notes.md

@@ -0,0 +1,9 @@
+## 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))

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

@@ -1,5 +1,16 @@
 # Changelog
 
+## 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)
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atlan-application-sdk
-Version: 0.1.1rc44
+Version: 0.1.1rc45
 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.1rc45}/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.1rc45}/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.1rc45/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.1rc45/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.1rc45/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.1rc45/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.1rc45}/application_sdk/version.py

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