cnhkmcp 1.1.9__tar.gz → 1.2.1__tar.gz

{cnhkmcp-1.1.9/cnhkmcp.egg-info → cnhkmcp-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cnhkmcp
-Version: 1.1.9
+Version: 1.2.1
 Summary: A comprehensive Model Context Protocol (MCP) server for quantitative trading platform integration
 Home-page: https://github.com/cnhk/cnhkmcp
 Author: CNHK

{cnhkmcp-1.1.9 → cnhkmcp-1.2.1}/cnhkmcp/__init__.py

@@ -50,7 +50,7 @@ from .untracked.forum_functions import (
     read_full_forum_post
 )
 
-__version__ = "1.1.9"
+__version__ = "1.2.1"
 __author__ = "CNHK"
 __email__ = "cnhk@example.com"
 

{cnhkmcp-1.1.9 → cnhkmcp-1.2.1}/cnhkmcp/untracked/platform_functions.py

@@ -436,22 +436,53 @@ class BrainApiClient:
         try:
             response = self.session.get(f"{self.base_url}/alphas/{alpha_id}/recordsets/pnl")
             response.raise_for_status()
-            return response.json()
+            # Some alphas may return 204 No Content or an empty body
+            text = (response.text or "").strip()
+            if not text:
+                return {}
+            try:
+                return response.json()
+            except Exception as parse_err:
+                self.log(f"PnL JSON parse failed for {alpha_id}: {parse_err}", "WARNING")
+                return {}
         except Exception as e:
             self.log(f"Failed to get alpha PnL: {str(e)}", "ERROR")
             raise
     
-    async def get_user_alphas(self, stage: str = "IS", limit: int = 100, offset: int = 0) -> Dict[str, Any]:
-        """Get user's alphas."""
+    async def get_user_alphas(
+        self,
+        stage: str = "OS",
+        limit: int = 30,
+        offset: int = 0,
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None,
+        submission_start_date: Optional[str] = None,
+        submission_end_date: Optional[str] = None,
+        order: Optional[str] = None,
+        hidden: Optional[bool] = None,
+    ) -> Dict[str, Any]:
+        """Get user's alphas with advanced filtering."""
         await self.ensure_authenticated()
         
         try:
             params = {
-                'stage': stage,
-                'limit': limit,
-                'offset': offset
+                "stage": stage,
+                "limit": limit,
+                "offset": offset,
             }
-            
+            if start_date:
+                params["dateCreated>"] = start_date
+            if end_date:
+                params["dateCreated<"] = end_date
+            if submission_start_date:
+                params["dateSubmitted>"] = submission_start_date
+            if submission_end_date:
+                params["dateSubmitted<"] = submission_end_date
+            if order:
+                params["order"] = order
+            if hidden is not None:
+                params["hidden"] = str(hidden).lower()
+
             response = self.session.get(f"{self.base_url}/users/self/alphas", params=params)
             response.raise_for_status()
             return response.json()
@@ -763,9 +794,11 @@ class BrainApiClient:
         await self.ensure_authenticated()
         
         try:
-            response = self.session.get(f"{self.base_url}/alphas/{alpha_id}/recordsets/production-correlation")
+            response = self.session.get(f"{self.base_url}/alphas/{alpha_id}/correlations/prod")
             response.raise_for_status()
-            return response.json()
+            if response.text:
+                return response.json()
+            return {}  # Return empty dict for empty response
         except Exception as e:
             self.log(f"Failed to get production correlation: {str(e)}", "ERROR")
             raise
@@ -775,9 +808,11 @@ class BrainApiClient:
         await self.ensure_authenticated()
         
         try:
-            response = self.session.get(f"{self.base_url}/alphas/{alpha_id}/recordsets/self-correlation")
+            response = self.session.get(f"{self.base_url}/alphas/{alpha_id}/correlations/self")
             response.raise_for_status()
-            return response.json()
+            if response.text:
+                return response.json()
+            return {}  # Return empty dict for empty response
         except Exception as e:
             self.log(f"Failed to get self correlation: {str(e)}", "ERROR")
             raise
@@ -1473,20 +1508,69 @@ async def get_alpha_pnl(alpha_id: str) -> Dict[str, Any]:
         return {"error": str(e)}
 
 @mcp.tool()
-async def get_user_alphas(stage: str = "IS", limit: int = 100, offset: int = 0) -> Dict[str, Any]:
+async def get_user_alphas(
+    stage: str = "IS",
+    limit: int = 30,
+    offset: int = 0,
+    start_date: Optional[str] = None,
+    end_date: Optional[str] = None,
+    submission_start_date: Optional[str] = None,
+    submission_end_date: Optional[str] = None,
+    order: Optional[str] = None,
+    hidden: Optional[bool] = None,
+) -> Dict[str, Any]:
     """
-    👤 Get user's alphas.
-    
+    👤 Get user's alphas with advanced filtering, pagination, and sorting.
+
+    This tool retrieves a list of your alphas, allowing for detailed filtering based on stage,
+    creation date, submission date, and visibility. It also supports pagination and custom sorting.
+
     Args:
-        stage: Alpha stage ("IS" for in-sample, "OS" for out-of-sample)
-        limit: Maximum number of alphas to return
-        offset: Offset for pagination, if the desired total number is larger than 100. then it is useful, every page, the load max is 100 alphas.
+        stage (str): The stage of the alphas to retrieve.
+            - "IS": In-Sample (alphas that have not been submitted).
+            - "OS": Out-of-Sample (alphas that have been submitted).
+            Defaults to "IS".
+        limit (int): The maximum number of alphas to return in a single request.
+            For example, `limit=50` will return at most 50 alphas. Defaults to 30.
+        offset (int): The number of alphas to skip from the beginning of the list.
+            Used for pagination. For example, `limit=50, offset=50` will retrieve alphas 51-100.
+            Defaults to 0.
+        start_date (Optional[str]): The earliest creation date for the alphas to be included.
+            Filters for alphas created on or after this date.
+            Example format: "2023-01-01T00:00:00Z".
+        end_date (Optional[str]): The latest creation date for the alphas to be included.
+            Filters for alphas created before this date.
+            Example format: "2023-12-31T23:59:59Z".
+        submission_start_date (Optional[str]): The earliest submission date for the alphas.
+            Only applies to "OS" alphas. Filters for alphas submitted on or after this date.
+            Example format: "2024-01-01T00:00:00Z".
+        submission_end_date (Optional[str]): The latest submission date for the alphas.
+            Only applies to "OS" alphas. Filters for alphas submitted before this date.
+            Example format: "2024-06-30T23:59:59Z".
+        order (Optional[str]): The sorting order for the returned alphas.
+            Prefix with a hyphen (-) for descending order.
+            Examples: "name" (sort by name ascending), "-dateSubmitted" (sort by submission date descending).
+        hidden (Optional[bool]): Filter alphas based on their visibility.
+            - `True`: Only return hidden alphas.
+            - `False`: Only return non-hidden alphas.
+            If not provided, both hidden and non-hidden alphas are returned.
 
     Returns:
-        User's alphas
+        Dict[str, Any]: A dictionary containing a list of alpha details under the 'results' key,
+        along with pagination information. If an error occurs, it returns a dictionary with an 'error' key.
     """
     try:
-        return await brain_client.get_user_alphas(stage, limit, offset)
+        return await brain_client.get_user_alphas(
+            stage=stage,
+            limit=limit,
+            offset=offset,
+            start_date=start_date,
+            end_date=end_date,
+            submission_start_date=submission_start_date,
+            submission_end_date=submission_end_date,
+            order=order,
+            hidden=hidden,
+        )
     except Exception as e:
         return {"error": str(e)}
 
@@ -1564,35 +1648,7 @@ async def save_simulation_data(simulation_id: str, filename: str) -> Dict[str, A
     except Exception as e:
         return {"error": str(e)}
 
-@mcp.tool()
-async def analyze_alpha_performance(alpha_id: str) -> Dict[str, Any]:
-    """
-    📊 Comprehensive alpha performance analysis.
-    
-    Args:
-        alpha_id: The alpha ID to analyze
-    
-    Returns:
-        Comprehensive performance analysis
-    """
-    try:
-        # Get alpha details
-        alpha_details = await brain_client.get_alpha_details(alpha_id)
-        
-        # Get PnL data
-        pnl_data = await brain_client.get_alpha_pnl(alpha_id)
-        
-        # Get yearly stats if available
-        yearly_stats = await brain_client.get_alpha_yearly_stats(alpha_id)
-        
-        return {
-            "alpha_details": alpha_details,
-            "pnl_data": pnl_data,
-            "yearly_stats": yearly_stats,
-            "analysis_timestamp": datetime.now().isoformat()
-        }
-    except Exception as e:
-        return {"error": str(e)}
+
 
 @mcp.tool()
 async def get_operators() -> Dict[str, Any]:

{cnhkmcp-1.1.9 → cnhkmcp-1.2.1/cnhkmcp.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cnhkmcp
-Version: 1.1.9
+Version: 1.2.1
 Summary: A comprehensive Model Context Protocol (MCP) server for quantitative trading platform integration
 Home-page: https://github.com/cnhk/cnhkmcp
 Author: CNHK

{cnhkmcp-1.1.9 → cnhkmcp-1.2.1}/setup.py

@@ -13,7 +13,7 @@ def read_requirements():
 
 setup(
     name="cnhkmcp",
-    version="1.1.9",
+    version="1.2.1",
     author="CNHK",
     author_email="cnhk@example.com",
     description="A comprehensive Model Context Protocol (MCP) server for quantitative trading platform integration",