Merge pull request #19 from signnow/feat/add-mcp-resources

Add stateless_http parameter to server and improve list_document_grou…

Author: mihasicehcek

src/sn_mcp_server/server.py

@@ -6,11 +6,11 @@
 from .tools import register_tools
 
 
-def create_server(cfg: Settings | None = None) -> FastMCP[Any]:
+def create_server(cfg: Settings | None = None, stateless_http: bool = False) -> FastMCP[Any]:
     """Create and configure FastMCP server instance"""
     cfg = cfg or load_settings()
 
-    mcp: FastMCP[Any] = FastMCP("sn-mcp-server")
+    mcp: FastMCP[Any] = FastMCP("sn-mcp-server", stateless_http=stateless_http)
     register_tools(mcp, cfg)
     # load_plugins(mcp, cfg)
     return mcp

src/sn_mcp_server/tools/signnow.py

@@ -75,7 +75,7 @@ def _get_token_and_client(token_provider: TokenProvider) -> tuple[str, SignNowAP
     return token, client
 
 
-def _normalize_orders(orders: Any, order_type: type) -> list[Any]:
+def _normalize_orders(orders: Any, order_type: type) -> list[Any]:  # noqa: ANN401
     """Normalize orders parameter - handle both list and JSON string inputs.
 
     Args:
@@ -132,7 +132,7 @@ def _normalize_orders(orders: Any, order_type: type) -> list[Any]:
     raise ValueError(f"Invalid orders type: {type(orders)}")
 
 
-def bind(mcp: Any, cfg: Any) -> None:
+def bind(mcp: Any, cfg: Any) -> None:  # noqa: ANN401
     # Initialize token provider
     token_provider = TokenProvider()
 
@@ -169,13 +169,21 @@ def _list_document_groups_impl(ctx: Context, limit: int = 50, offset: int = 0) -
         token, client = _get_token_and_client(token_provider)
         return _list_document_groups(token, client, limit, offset)
 
-    @mcp.tool(name="list_document_groups", description="Get simplified list of document groups with basic information." + TOOL_FALLBACK_SUFFIX, tags=["document_group", "list"])
+    @mcp.tool(
+        name="list_document_groups",
+        description=("Get simplified list of documents and document groups with basic information. " "Returns both documents and document groups in a unified format. " + TOOL_FALLBACK_SUFFIX),
+        tags=["document_group", "list"],
+    )
     def list_document_groups(
         ctx: Context,
         limit: Annotated[int, Field(ge=1, le=50, description="Maximum number of document groups to return (default: 50, max: 50)")] = 50,
         offset: Annotated[int, Field(ge=0, description="Number of document groups to skip for pagination (default: 0)")] = 0,
     ) -> SimplifiedDocumentGroupsResponse:
-        """Provide simplified list of document groups with basic fields.
+        """Provide simplified list of documents and document groups with basic fields.
+
+        This tool retrieves both individual documents and document groups from SignNow,
+        presenting them all in a unified format. If you need a list of documents or
+        a list of document groups, this is the right tool to use.
 
         Args:
             limit: Maximum number of document groups to return (default: 50, max: 50)
@@ -186,7 +194,7 @@ def list_document_groups(
     @mcp.resource(
         "signnow://document-groups/{?limit,offset}",
         name="list_document_groups_resource",
-        description="Get simplified list of document groups with basic information." + RESOURCE_PREFERRED_SUFFIX,
+        description=("Get simplified list of documents and document groups with basic information. " "Returns both documents and document groups in a unified format. " + RESOURCE_PREFERRED_SUFFIX),
         tags=["document_group", "list"],
         mime_type="application/json",
     )