suprema-biostar-mcp 1.0.1__py3-none-any.whl

biostar_x_mcp_server/schemas/doors.py

@@ -0,0 +1,306 @@
+from typing import Optional, Union, List
+from pydantic import BaseModel, Field, model_validator
+
+
+# ============================================================================
+# Door Schemas
+# ============================================================================
+
+class GetDoorsInput(BaseModel):
+    """Input schema for get-doors tool"""
+    limit: Optional[int] = Field(None, description="Number of records (0 = all). Default: 0.")
+    order_by: Optional[str] = Field(None, description="Sort order, e.g., 'id:true' (asc) or 'id:false' (desc).")
+    ids: Optional[List[int]] = Field(None, description="Filter by specific door IDs.")
+    name: Optional[str] = Field(None, description="Exact door name match.")
+    name_contains: Optional[str] = Field(None, description="Case-insensitive substring match for door name.")
+    group_id: Optional[int] = Field(None, description="Filter by door group ID.")
+    group_name: Optional[str] = Field(None, description="Case-insensitive substring match for door group name.")
+    status: Optional[str] = Field(None, description="Filter by status value (as returned by API), e.g., '0'.")
+    include_raw: Optional[bool] = Field(default=False, description="Attach raw API row for each door (debugging). Default: false.")
+    minimal: Optional[bool] = Field(default=False, description="Return only id and name (for access level creation). Reduces response size from 13KB to <1KB. Default: false.")
+
+
+class GetDoorInput(BaseModel):
+    """Input schema for get-door tool"""
+    door_id: Optional[int] = Field(None, description="ID of the door to retrieve. If provided, the tool skips search and fetches details.")
+    search_text: Optional[str] = Field(None, description="Free-text query for door search (POST /api/v2/doors/search).")
+    door_group_id: Optional[int] = Field(None, description="Filter by door group ID in search (POST /api/v2/doors/search).")
+    limit: Optional[int] = Field(None, description="Max results for search (default: 50).")
+
+    @model_validator(mode="after")
+    def validate_identifier(self):
+        """Ensure at least one identifier is provided"""
+        if not any([self.door_id, self.search_text, self.door_group_id]):
+            raise ValueError("At least one of door_id, search_text, or door_group_id must be provided")
+        return self
+
+
+class CreateDoorInput(BaseModel):
+    """Input schema for create-door tool"""
+    name: str = Field(..., description="Door name")
+    entry_device_id: int = Field(..., description="Device id to control the lock (1:1 mapping enforced).")
+    exit_device_id: int = Field(..., description="Exit device id")
+    exit_input_index: int = Field(..., description="Exit input index")
+    exit_input_type: int = Field(..., description="1=NC, 0=NO")
+    sensor_device_id: int = Field(..., description="Sensor device id")
+    sensor_input_index: int = Field(..., description="Sensor input index")
+    sensor_input_type: int = Field(..., description="1=NC, 0=NO")
+    apb_use_door_sensor: int = Field(..., description="APB use door sensor")
+    confirm: Optional[bool] = Field(default=False, description="If true, actually create the door. If false, return a preview.")
+    default_group_id: Optional[int] = Field(default=1, description="Fallback group id when door_group_id is not provided.")
+    description: Optional[str] = Field(None, description="Door description")
+    door_group_id: Optional[int] = Field(None, description="Optional group id at creation time. If omitted, default_group_id is used.")
+    open_timeout: Optional[int] = Field(default=10, description="Open timeout")
+    open_duration: Optional[int] = Field(default=5, description="Open duration")
+    open_once: Optional[bool] = Field(default=True, description="Open once")
+    unconditional_lock: Optional[bool] = Field(default=True, description="Unconditional lock")
+    relay_index: Optional[int] = Field(None, description="Relay index on the entry device. If omitted, the tool returns relay list and exits.")
+
+
+class UpdateDoorInput(BaseModel):
+    """Input schema for update-door tool"""
+    door_id: int = Field(..., description="ID of the door to update")
+    name: Optional[str] = Field(None, description="New name for the door")
+    open_duration: Optional[int] = Field(None, description="Door open duration in seconds")
+    open_timeout: Optional[int] = Field(None, description="Door open timeout in seconds")
+    dual_auth_required: Optional[bool] = Field(None, description="Whether dual authentication is required")
+
+
+class DeleteDoorInput(BaseModel):
+    """Input schema for delete-door tool"""
+    door_id: int = Field(..., description="ID of the door to delete")
+
+
+class ControlDoorInput(BaseModel):
+    """Input schema for control-door tool"""
+    action: str = Field(..., description="Action to perform. 'release' clears manual lock/unlock.", pattern="^(open|release|lock|unlock)$")
+    door_ids: Optional[List[Union[int, str]]] = Field(None, description="Door IDs to control (validated against GET /api/doors).")
+    door_names: Optional[List[str]] = Field(None, description="Door names to control (EXACT, case-sensitive). No autocorrect, no fuzzy.")
+
+
+class GetDoorsStatusInput(BaseModel):
+    """Input schema for get-doors-status tool"""
+    monitoring_permission: Optional[bool] = Field(default=True, description="Pass-through flag for the status API. Default: true.")
+    include_enrichment: Optional[bool] = Field(default=True, description="If true, joins names/groups from GET /api/doors and enables group/name filters. Default: true.")
+    include_device_response: Optional[bool] = Field(default=True, description="Include normalized DeviceResponse with error summary. Default: true.")
+    include_raw: Optional[bool] = Field(default=False, description="Attach raw status row for debugging. Default: false.")
+    door_ids: Optional[List[int]] = Field(None, description="Filter to specific door IDs.")
+    is_open: Optional[bool] = Field(None, description="Filter by open state.")
+    is_unlocked: Optional[bool] = Field(None, description="Filter by unlocked state.")
+    has_alarm: Optional[bool] = Field(None, description="Filter by alarm state.")
+    status_in: Optional[List[str]] = Field(None, description="Filter by raw status code values (as strings).")
+    group_id: Optional[int] = Field(None, description="Filter by door group ID (requires include_enrichment=true).")
+    group_name: Optional[str] = Field(None, description="Substring match for group name (requires include_enrichment=true).")
+    name_contains: Optional[str] = Field(None, description="Substring match for door name (requires include_enrichment=true).")
+    sort_by: Optional[str] = Field(default="door_id", description="Client-side sort key. Default: 'door_id'.")
+    sort_desc: Optional[bool] = Field(default=False, description="Sort descending when true. Default: false.")
+
+
+# ============================================================================
+# Door Group Schemas
+# ============================================================================
+
+class GetDoorGroupsInput(BaseModel):
+    """Input schema for get-door-groups tool"""
+    include_hierarchy: Optional[bool] = Field(default=True, description="Enrich with /api/v2/door_groups/only_permission_item/search (depth/parent/children/path). Default: true")
+    include_doors_scan: Optional[bool] = Field(default=True, description="Enrich with /api/doors to fill door_ids and door_count when absent. Default: true")
+
+
+class GetDoorGroupInput(BaseModel):
+    """Input schema for get-door-group tool"""
+    group_id: Optional[Union[int, str]] = Field(None, description="ID of the door group to retrieve")
+    group_name: Optional[str] = Field(None, description="Name of the door group to resolve (supports exact/iexact/icontains via name_match_mode)")
+    name_match_mode: Optional[str] = Field(default="auto", description="Name matching strategy when group_name is provided")
+    include_hierarchy: Optional[bool] = Field(default=True, description="Include depth/parent/children/path if available")
+    include_doors: Optional[bool] = Field(default=True, description="Include door_ids (scan /api/doors if missing)")
+    include_doors_detail: Optional[bool] = Field(default=False, description="Also include brief door objects (id, name, description, group)")
+    include_raw: Optional[bool] = Field(default=False, description="Attach raw DoorGroup payload")
+
+    @model_validator(mode="after")
+    def validate_identifier(self):
+        """Ensure at least one identifier is provided"""
+        if not any([self.group_id, self.group_name]):
+            raise ValueError("Either group_id or group_name must be provided")
+        return self
+
+
+class CreateDoorGroupInput(BaseModel):
+    """Input schema for create-door-group tool"""
+    name: str = Field(..., description="Name of the door group (e.g., 'Ground Floor', '1st Floor', '2nd Floor')")
+    parent_id: Optional[int] = Field(default=1, description="Parent door group ID (default: 1 for root group)")
+    depth: Optional[int] = Field(default=1, ge=1, le=8, description="Depth level of the door group (1-8, default: 1)")
+
+
+class UpdateDoorGroupInput(BaseModel):
+    """Input schema for update-door-group tool"""
+    group_id: int = Field(..., description="ID of the door group to update")
+    name: Optional[str] = Field(None, description="New name for the door group")
+    parent_id: Optional[int] = Field(None, description="New parent door group ID")
+
+
+class DeleteDoorGroupInput(BaseModel):
+    """Input schema for delete-door-group tool"""
+    group_id: int = Field(..., description="ID of the door group to delete")
+
+
+class AddDoorsToGroupInput(BaseModel):
+    """Input schema for add-doors-to-group tool"""
+    group_id: Optional[int] = Field(None, description="Target door group ID")
+    group_name: Optional[str] = Field(None, description="Target door group name (used when group_id is not provided)")
+    door_ids: Optional[List[int]] = Field(None, description="List of door IDs to assign")
+    door_names: Optional[List[str]] = Field(None, description="List of door names to assign (exact match)")
+    force: Optional[bool] = Field(default=False, description="Overwrite an existing single-group assignment if different.")
+
+
+class RemoveDoorsFromGroupInput(BaseModel):
+    """Input schema for remove-doors-from-group tool"""
+    door_ids: Optional[List[int]] = Field(None, description="Door IDs")
+    door_names: Optional[List[str]] = Field(None, description="Door names")
+    group_id: Optional[int] = Field(None, description="Remove from this group id")
+    group_name: Optional[str] = Field(None, description="Or remove from this group name")
+    fallback_mode: Optional[str] = Field(default="auto", description="What to do if removal would leave no group")
+    fallback_group_id: Optional[int] = Field(None, description="Required when fallback_mode='assign'")
+
+
+class UpdateDoorDescriptionInput(BaseModel):
+    """Input schema for update-door-description tool"""
+    door_id: int = Field(..., description="ID of the door to update")
+    description: str = Field(..., description="New description to set. Pass an empty string to clear.")
+
+
+class SetDoorAutoModeInput(BaseModel):
+    """Input schema for set-door-auto-mode tool"""
+    door_id: Optional[int] = Field(None, description="Door ID")
+    door_name: Optional[str] = Field(None, description="Exact door name (alternative to door_id)")
+    enable: Optional[bool] = Field(None, description="true to enable, false to disable")
+
+    @model_validator(mode="after")
+    def validate_identifier(self):
+        """Ensure door identifier and enable are provided"""
+        if not any([self.door_id, self.door_name]):
+            raise ValueError("Either door_id or door_name must be provided")
+        if self.enable is None:
+            raise ValueError("enable must be provided")
+        return self
+
+
+class SetDoorRelockOnCloseInput(BaseModel):
+    """Input schema for set-door-relock-on-close tool"""
+    door_id: Optional[int] = Field(None, description="Door ID")
+    door_name: Optional[str] = Field(None, description="Exact door name (alternative to door_id)")
+    enable: Optional[bool] = Field(None, description="true to enable, false to disable")
+
+    @model_validator(mode="after")
+    def validate_identifier(self):
+        """Ensure door identifier and enable are provided"""
+        if not any([self.door_id, self.door_name]):
+            raise ValueError("Either door_id or door_name must be provided")
+        if self.enable is None:
+            raise ValueError("enable must be provided")
+        return self
+
+
+class SetDoorOpenDurationInput(BaseModel):
+    """Input schema for set-door-open-duration tool"""
+    door_id: Optional[int] = Field(None, description="ID of the door to update")
+    door_name: Optional[str] = Field(None, description="Exact door name (alternative to door_id)")
+    seconds: Optional[int] = Field(None, ge=1, le=900, description="New open duration in seconds (sent as string). Range: 1–900 (inclusive).")
+
+    @model_validator(mode="after")
+    def validate_identifier(self):
+        """Ensure door identifier and seconds are provided"""
+        if not any([self.door_id, self.door_name]):
+            raise ValueError("Either door_id or door_name must be provided")
+        if self.seconds is None:
+            raise ValueError("seconds must be provided")
+        return self
+
+
+class SetDoorTimedAPBInput(BaseModel):
+    """Input schema for set-door-timed-apb tool"""
+    door_id: Optional[int] = Field(None, description="Door ID (optional). Either door_id or door_name is required.")
+    door_name: Optional[str] = Field(None, description="Exact door name (optional). Either door_id or door_name is required.")
+    mode: Optional[Union[str, int]] = Field(None, description="APB mode: off | entry | exit (also accepts 0/1/2).")
+    reset_time: Optional[int] = Field(None, ge=0, le=60, description="APB reset time in minutes. 0..60 inclusive. Required when mode != off.")
+    bypass_group_ids: Optional[List[int]] = Field(None, description="Optional: Access Group IDs for timed APB bypass. If omitted, preserves current.")
+
+    @model_validator(mode="after")
+    def validate_identifier(self):
+        """Ensure door identifier and mode are provided"""
+        if not any([self.door_id, self.door_name]):
+            raise ValueError("Either door_id or door_name must be provided")
+        if self.mode is None:
+            raise ValueError("mode must be provided")
+        return self
+
+
+class SetDoorClassicAPBInput(BaseModel):
+    """Input schema for set-door-classic-apb tool"""
+    door_id: Optional[int] = Field(None, description="Door ID (optional). Either door_id or door_name is required.")
+    door_name: Optional[str] = Field(None, description="Exact door name (optional). Either door_id or door_name is required.")
+    apb_type: Optional[Union[str, int]] = Field(None, description="APB type: none | soft | hard (also accepts 0/1/2).")
+
+    @model_validator(mode="after")
+    def validate_identifier(self):
+        """Ensure door identifier and apb_type are provided"""
+        if not any([self.door_id, self.door_name]):
+            raise ValueError("Either door_id or door_name must be provided")
+        if self.apb_type is None:
+            raise ValueError("apb_type must be provided")
+        return self
+
+
+class SetDoorIOInput(BaseModel):
+    """Input schema for set-door-io tool"""
+    door_id: Optional[int] = Field(None, description="ID of the door to update.")
+    door_name: Optional[str] = Field(None, description="Exact door name to update.")
+    entry_device_id: Optional[Union[int, None]] = Field(None, description="Device id for entry reader, or null to clear.")
+    entry_device_name: Optional[Union[str, None]] = Field(None, description="Device name for entry reader; 'none' to clear.")
+    relay_device_id: Optional[int] = Field(None, description="Device id hosting the relay.")
+    relay_device_name: Optional[str] = Field(None, description="Device name hosting the relay.")
+    relay_index: Optional[int] = Field(None, description="Relay index on the device.")
+    exit_button_device_id: Optional[int] = Field(None, description="Device id for the exit button input.")
+    exit_button_device_name: Optional[str] = Field(None, description="Device name for the exit button input.")
+    exit_button_input_index: Optional[int] = Field(None, description="Input index (e.g., 0 or 1).")
+    exit_button_input_type: Optional[int] = Field(None, description="Input type: 1=NC, 0=NO")
+    sensor_device_id: Optional[int] = Field(None, description="Device id for the door sensor input.")
+    sensor_device_name: Optional[str] = Field(None, description="Device name for the door sensor input.")
+    sensor_input_index: Optional[int] = Field(None, description="Input index (e.g., 0 or 1).")
+    sensor_input_type: Optional[int] = Field(None, description="Input type: 1=NC, 0=NO")
+    sensor_apb_use: Optional[Union[bool, int, str]] = Field(None, description="Whether to use the door sensor for APB (apb_use_door_sensor). Accepts boolean or 0/1/'0'/'1'.")
+
+    @model_validator(mode="after")
+    def validate_identifier(self):
+        """Ensure door identifier is provided"""
+        if not any([self.door_id, self.door_name]):
+            raise ValueError("Either door_id or door_name must be provided")
+        return self
+
+
+class BulkCreateDoorItemInput(BaseModel):
+    """Input schema for bulk-create-doors door item"""
+    name: str = Field(..., description="Door name")
+    entry_device_id: int = Field(..., description="Device id to control the lock (1:1 mapping enforced).")
+    exit_device_id: int = Field(..., description="Exit button device id.")
+    exit_input_index: int = Field(..., description="Exit input index.")
+    exit_input_type: int = Field(..., description="Exit input type.")
+    sensor_device_id: int = Field(..., description="Door sensor device id.")
+    sensor_input_index: int = Field(..., description="Sensor input index.")
+    sensor_input_type: int = Field(..., description="Sensor input type.")
+    apb_use_door_sensor: int = Field(..., description="Use door sensor for APB.")
+    confirm: Optional[bool] = Field(default=False, description="If true and all required fields are valid, creation proceeds.")
+    default_group_id: Optional[int] = Field(default=1, description="Fallback door group id when 'door_group_id' is not provided.")
+    description: Optional[str] = Field(None, description="Door description")
+    door_group_id: Optional[int] = Field(None, description="Door group id to assign at creation time")
+    open_timeout: Optional[int] = Field(default=10, description="Door open timeout (sec).")
+    open_duration: Optional[int] = Field(default=5, description="Door open duration (sec).")
+    open_once: Optional[bool] = Field(default=True, description="Open once option.")
+    unconditional_lock: Optional[bool] = Field(default=True, description="Unconditional lock option.")
+    relay_index: Optional[int] = Field(None, description="Required to actually create. If missing, tool returns relay options and stops.")
+
+
+class BulkCreateDoorsInput(BaseModel):
+    """Input schema for bulk-create-doors tool"""
+    doors: List[BulkCreateDoorItemInput] = Field(..., description="List of door payloads. Each item uses the same schema as 'create-door'.")
+    continue_on_error: Optional[bool] = Field(default=True, description="If false, stop at the first failure. Default: true.")
+

biostar_x_mcp_server/schemas/events.py

@@ -0,0 +1,104 @@
+from typing import Optional, List, Union
+from pydantic import BaseModel, Field
+
+
+# ============================================================================
+# Event Condition Schemas (nested)
+# ============================================================================
+
+class EventConditionInput(BaseModel):
+    """Input schema for event condition item"""
+    column: str = Field(..., description="Column name")
+    operator: int = Field(..., ge=0, le=6, description="Operator (0=EQUAL, 1=NOT_EQUAL, 2=CONTAINS, 3=BETWEEN, 5=GREATER, 6=LESS)")
+    value: Optional[List[Union[str, int, float]]] = Field(None, description="Value array")
+    values: Optional[List[Union[str, int, float]]] = Field(None, description="Values array")
+
+
+# ============================================================================
+# Event Search Schemas
+# ============================================================================
+
+class GetEventTypesInput(BaseModel):
+    """Input schema for get-event-types tool"""
+    is_break_glass: Optional[bool] = Field(default=False, description="If true, list user-renamed (break-glass) names. When true and others not specified, setting_alert/setting_all default to false.")
+    setting_alert: Optional[bool] = Field(default=True, description="If true, list alertable event types (server-side filter).")
+    setting_all: Optional[bool] = Field(default=True, description="If true, list all event types (server-side filter).")
+    search: Optional[str] = Field(None, description="Case-insensitive contains across code, name, and description.")
+    codes: Optional[List[Union[str, int]]] = Field(None, description="Restrict to specific event code(s).")
+    only_alertable: Optional[bool] = Field(default=False, description="Keep only items with alertable == true.")
+    only_enable_alert: Optional[bool] = Field(default=False, description="Keep only items with enable_alert == true.")
+    sort_by: Optional[str] = Field(default="code", description="Sort field (default: code).")
+    sort_desc: Optional[bool] = Field(default=False, description="Descending sort if true.")
+    offset: Optional[int] = Field(default=0, description="Start index for slicing.")
+    limit: Optional[int] = Field(None, description="Maximum number of items to return (client-side slicing).")
+    group_by: Optional[str] = Field(default="none", description="Group the result by a boolean field.")
+
+
+class SearchEventsInput(BaseModel):
+    """Input schema for search-events tool"""
+    conditions: Optional[List[EventConditionInput]] = Field(None, description="Array of search conditions (for advanced filters only, do NOT use for datetime or user_id)")
+    user_id: Optional[Union[str, int]] = Field(None, description="User ID to filter events (e.g., '61061'). Use this instead of conditions array.")
+    user_name: Optional[str] = Field(None, description="User name to filter events. Server will resolve name to user_id.")
+    start_datetime: Optional[str] = Field(None, description="Start datetime: 'YYYY-MM-DDTHH:MM:SS' (e.g., '2025-11-07T00:00:00'). WITHOUT timezone. Server converts to UTC.")
+    end_datetime: Optional[str] = Field(None, description="End datetime: 'YYYY-MM-DDTHH:MM:SS' (e.g., '2025-11-07T23:59:59'). WITHOUT timezone. Server converts to UTC.")
+    limit: Optional[int] = Field(default=100, description="Limit")
+    offset: Optional[int] = Field(default=0, description="Offset")
+    order_by: Optional[str] = Field(default="datetime", description="Order by")
+    order_type: Optional[str] = Field(default="desc", description="Order type")
+
+
+class GetRealtimeEventsInput(BaseModel):
+    """Input schema for get-realtime-events tool"""
+    duration: Optional[int] = Field(default=60, le=300, description="Duration to monitor events in seconds (max: 300)")
+    event_types: Optional[List[str]] = Field(None, description="Filter real-time events by specific event type IDs")
+
+
+class GetAccessLogsInput(BaseModel):
+    """Input schema for get-access-logs tool"""
+    start_datetime: Optional[str] = Field(None, description="Start datetime in ISO 8601 format (e.g., \"2025-10-27T00:00:00.000Z\"). If not provided, defaults to 24 hours ago from NOW. NEVER use hardcoded dates.")
+    end_datetime: Optional[str] = Field(None, description="End datetime in ISO 8601 format (e.g., \"2025-10-27T23:59:59.999Z\"). If not provided, defaults to NOW. NEVER use hardcoded dates.")
+    user_name: Optional[str] = Field(None, description="Filter by user name (partial match)")
+    success_only: Optional[bool] = Field(default=False, description="Show only successful access attempts")
+    limit: Optional[int] = Field(default=100, description="Maximum number of logs to retrieve")
+
+
+class EventExportConditionInput(BaseModel):
+    """Input schema for export-events-csv condition item"""
+    column: str = Field(..., description="Column name")
+    operator: int = Field(..., description="Operator")
+    values: List[Union[str, int, float]] = Field(..., description="Values array")
+
+
+class ExportEventsCSVInput(BaseModel):
+    """Input schema for export-events-csv tool"""
+    start_datetime: str = Field(..., description="Start datetime (ISO 8601 with Z). If 'conditions' omitted, this and end_datetime build a BETWEEN.")
+    end_datetime: str = Field(..., description="End datetime (ISO 8601 with Z).")
+    conditions: Optional[List[EventExportConditionInput]] = Field(None, description="Custom conditions for the Query. If provided, takes precedence.")
+    user_id: Optional[Union[str, int]] = Field(None, description="Convenience filter: constrains to this user_id (mapped to column 'user_id.user_id').")
+    user_name: Optional[str] = Field(None, description="Convenience filter: resolve name → user_id and filter (exact match preferred).")
+    event_types: Optional[List[Union[str, int]]] = Field(None, description="Convenience filter: adds EQUAL condition on event_type_id with provided values.")
+    columns: Optional[List[str]] = Field(
+        default=["datetime","door_id.name","device_id.id","device_id.name","user_group_id","user_id","temperature","event_type_id","tna_key"],
+        description="Columns to export (default matches BioStar example)."
+    )
+    headers: Optional[List[str]] = Field(
+        default=["Date","Door","Device ID","Device","User Group","User","Temperature","Event","TNA Key"],
+        description="CSV headers (must match columns length)."
+    )
+    offset: Optional[int] = Field(default=0, description="Offset for pagination.")
+    time_offset_minutes: Optional[int] = Field(default=0, description="Timezone offset in minutes, e.g., 480 for UTC+8.")
+    use_centigrade: Optional[bool] = Field(default=True, description="Whether to export temperature in centigrade.")
+    copy_to_downloads: Optional[bool] = Field(default=True, description="Copy exported CSV to Windows Downloads.")
+    dest_dir: Optional[str] = Field(None, description="Optional absolute destination directory (overrides Downloads).")
+    target_username: Optional[str] = Field(None, description="If provided, copies to C:\\Users\\<name>\\Downloads.")
+    filename: Optional[str] = Field(default="events_export.csv", description="Legacy/unused: server decides filename. Returned as 'filename' in response.")
+
+
+class GetTemperatureLogsInput(BaseModel):
+    """Input schema for get-temperature-logs tool"""
+    start_datetime: Optional[str] = Field(None, description="Start datetime for temperature log search in ISO 8601 format with Z suffix (e.g., \"2025-07-26T15:00:00.000Z\")")
+    end_datetime: Optional[str] = Field(None, description="End datetime for temperature log search in ISO 8601 format with Z suffix (e.g., \"2025-08-02T14:59:59.000Z\")")
+    user_id: Optional[str] = Field(None, description="Filter by specific user ID")
+    abnormal_only: Optional[bool] = Field(default=False, description="Show only abnormal temperature readings")
+    temperature_threshold: Optional[float] = Field(None, ge=35.0, le=42.0, description="Temperature threshold in Celsius (e.g., 37.5)")
+

biostar_x_mcp_server/schemas/files.py

@@ -0,0 +1,7 @@
+from pydantic import BaseModel, Field
+
+
+class ReadUploadedFileInput(BaseModel):
+    """Input schema for read-uploaded-file tool"""
+    filename: str = Field(..., description="Name of the uploaded file to read (e.g., 'users.csv')")
+

biostar_x_mcp_server/schemas/help.py

@@ -0,0 +1,29 @@
+from typing import Optional
+from pydantic import BaseModel, Field
+
+
+class VectorSearchHelpInput(BaseModel):
+    """Input schema for vector-search-help tool"""
+    query: str = Field(..., description="Question or keyword to search (e.g., 'how to create user', 'door API usage')")
+    tool_name: Optional[str] = Field(None, description="Specific tool name (optional, e.g., 'create-user')")
+    language: Optional[str] = Field(default="ko", description="Language selection (default: ko)")
+
+
+class VectorSearchAPIDocsInput(BaseModel):
+    """Input schema for vector-search-api-docs tool"""
+    query: str = Field(..., description="API-related question to search (e.g., 'list users', 'door unlock API')")
+    limit: Optional[int] = Field(default=10, ge=1, le=20, description="Number of results to return (default: 10, increased for better LLM selection)")
+
+
+class VectorSearchManualInput(BaseModel):
+    """Input schema for vector-search-manual tool"""
+    query: str = Field(..., description="Question to search (e.g., 'user management', 'access permission settings')")
+    language: Optional[str] = Field(default="ko", description="Language selection (default: ko)")
+    limit: Optional[int] = Field(default=10, ge=1, le=20, description="Number of results to return (default: 10, increased for better LLM selection)")
+
+
+class VectorGetToolHelpInput(BaseModel):
+    """Input schema for vector-get-tool-help tool"""
+    tool_name: str = Field(..., description="Tool name (e.g., 'create-user', 'list-doors')")
+    language: Optional[str] = Field(default="ko", description="Language selection (default: ko)")
+

biostar_x_mcp_server/schemas/logs.py

@@ -0,0 +1,33 @@
+from typing import Optional
+from pydantic import BaseModel, Field
+
+
+class AnalyzeServerLogsInput(BaseModel):
+    """Input schema for analyze_server_logs tool"""
+    log_path: Optional[str] = Field(default="C:\\Program Files\\BioStar X\\logs", description="로그 파일 경로 (기본값: C:\\Program Files\\BioStar X\\logs)")
+    lines_to_read: Optional[int] = Field(default=50, ge=20, le=100, description="각 로그 파일에서 읽을 줄 수 (기본값: 50)")
+
+
+class GetLogFileInfoInput(BaseModel):
+    """Input schema for get_log_file_info tool"""
+    log_path: Optional[str] = Field(default="C:\\Program Files\\BioStar X\\logs", description="로그 파일 경로 (기본값: C:\\Program Files\\BioStar X\\logs)")
+
+
+class ReadSpecificLogInput(BaseModel):
+    """Input schema for read_specific_log tool"""
+    log_file_path: str = Field(..., description="읽을 로그 파일의 전체 경로")
+    lines_to_read: Optional[int] = Field(default=50, ge=20, le=100, description="읽을 줄 수 (기본값: 50)")
+    from_end: Optional[bool] = Field(default=True, description="파일 끝에서부터 읽을지 여부 (기본값: true)")
+
+
+class GetSystemResourcesInput(BaseModel):
+    """Input schema for get_system_resources tool"""
+    include_all_processes: Optional[bool] = Field(default=False, description="모든 프로세스 정보 포함 여부 (기본값: false, BioStar 관련만)")
+
+
+class AnalyzeServerStatusInput(BaseModel):
+    """Input schema for analyze_server_status tool"""
+    log_path: Optional[str] = Field(default="C:\\Program Files\\BioStar X\\logs", description="로그 파일 경로 (기본값: C:\\Program Files\\BioStar X\\logs)")
+    lines_to_read: Optional[int] = Field(default=50, ge=20, le=100, description="각 로그 파일에서 읽을 줄 수 (기본값: 50)")
+    include_system_resources: Optional[bool] = Field(default=True, description="시스템 리소스 정보 포함 여부 (기본값: true)")
+

biostar_x_mcp_server/schemas/occupancy.py

@@ -0,0 +1,19 @@
+from typing import Optional
+from pydantic import BaseModel, Field
+
+
+class GetOccupancyStatusInput(BaseModel):
+    """Input schema for get-occupancy-status tool"""
+    door_name: Optional[str] = Field(None, description="출입문 이름 (예: '12층 메인 출입문'). If not provided, will analyze all doors.")
+    door_id: Optional[str] = Field(None, description="출입문 ID (door_name 대신 사용 가능)")
+    hours: Optional[int] = Field(default=24, description="분석할 시간 범위 (시간 단위, 기본값: 24시간)")
+    include_details: Optional[bool] = Field(default=True, description="상세 이벤트 정보 포함 여부 (기본값: true)")
+
+
+class AnalyzeDoorTrafficInput(BaseModel):
+    """Input schema for analyze-door-traffic tool"""
+    door_name: Optional[str] = Field(None, description="출입문 이름")
+    door_id: Optional[str] = Field(None, description="출입문 ID")
+    start_date: Optional[str] = Field(None, description="시작 날짜 (YYYY-MM-DD)")
+    end_date: Optional[str] = Field(None, description="종료 날짜 (YYYY-MM-DD)")
+

biostar_x_mcp_server/schemas/tool_response.py

@@ -0,0 +1,29 @@
+from typing import Optional, List, Dict, Any
+from pydantic import BaseModel
+
+
+class NavigationAction(BaseModel):
+    """Navigation action to perform on target page"""
+    type: str  # "click" or "scroll"
+    ng_label_key: str  # Angular label key to target
+
+
+class NavigationInfo(BaseModel):
+    """Frontend navigation information"""
+    enabled: bool = True
+    page_type: str  # user_list, user_detail, door_list, door_detail, device_list, device_detail, monitoring, custom_url
+    resource_id: Optional[str] = None  # For detail pages: user_id, door_id, device_id
+    custom_url: Optional[str] = None  # For custom_url page type
+    action: Optional[NavigationAction] = None  # Optional action on target page
+    reason: Optional[str] = None  # Why navigating to this page
+
+
+class ToolResponse(BaseModel):
+    message: str
+    method: str
+    navigate_to: Optional[str] = None  # Deprecated: use navigation instead
+    navigation: Optional[NavigationInfo] = None  # New structured navigation
+    query: Optional[Dict[str, Any]] = None
+    users: Optional[List[Dict[str, Any]]] = None
+    download_url: Optional[str] = None
+    filename: Optional[str] = None