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

biostar_x_mcp_server/__init__.py

@@ -0,0 +1,25 @@
+"""
+BioStar X MCP Server
+Lightweight MCP server for BioStar X integration
+
+Features:
+- Full BioStar X API integration (138+ tools)
+- Web-based documentation (no vector DB required)
+- Dynamic tool category loading
+- Session management with auto-refresh
+- Multi-language support (Korean/English)
+"""
+
+__version__ = "1.0.0"
+__author__ = "Suprema Inc."
+
+from .config import Config
+from .session import BioStarSession
+from .tool_manager import ToolManager
+
+__all__ = [
+    "Config",
+    "BioStarSession",
+    "ToolManager",
+    "__version__"
+]

biostar_x_mcp_server/__main__.py

@@ -0,0 +1,15 @@
+"""
+BioStar X MCP Server - Main Entry Point
+Run with: python -m biostar_x_mcp_server
+"""
+import asyncio
+import sys
+from pathlib import Path
+
+# Ensure the parent directory is in the path
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+from .server import main
+
+if __name__ == "__main__":
+    asyncio.run(main())

biostar_x_mcp_server/config.py

@@ -0,0 +1,87 @@
+"""
+BioStar X MCP Server Configuration
+Lightweight configuration without vector DB dependencies
+"""
+import os
+from typing import Optional
+from pydantic import BaseModel, Field
+from dotenv import load_dotenv
+
+load_dotenv()
+
+
+class Config(BaseModel):
+    """Configuration for BioStar X MCP Server (Lightweight)."""
+
+    # BioStar X API settings
+    biostar_url: str = Field(
+        default_factory=lambda: os.getenv("BIOSTAR_URL", "https://localhost"),
+        description="BioStar X server URL"
+    )
+    biostar_username: str = Field(
+        default_factory=lambda: os.getenv("BIOSTAR_USERNAME", ""),
+        description="BioStar X username"
+    )
+    biostar_password: str = Field(
+        default_factory=lambda: os.getenv("BIOSTAR_PASSWORD", ""),
+        description="BioStar X password"
+    )
+
+    # API settings
+    api_timeout: int = Field(
+        default_factory=lambda: int(os.getenv("API_TIMEOUT", "30")),
+        description="API request timeout in seconds"
+    )
+    verify_ssl: bool = Field(
+        default_factory=lambda: os.getenv("VERIFY_SSL", "true").lower() == "true",
+        description="Verify SSL certificates"
+    )
+
+    # Session settings
+    session_refresh_interval: int = Field(
+        default_factory=lambda: int(os.getenv("SESSION_REFRESH_INTERVAL", "3600")),
+        description="Session refresh interval in seconds"
+    )
+
+    # Server settings
+    debug: bool = Field(
+        default_factory=lambda: os.getenv("DEBUG", "false").lower() == "true",
+        description="Enable debug mode"
+    )
+
+    # Tool loading settings
+    default_categories: list[str] = Field(
+        default=["auth"],
+        description="Categories to load by default"
+    )
+    max_active_categories: int = Field(
+        default=15,
+        description="Maximum number of active tool categories"
+    )
+
+    # Documentation settings (Web-based help)
+    docs_base_url: str = Field(
+        default_factory=lambda: os.getenv("DOCS_BASE_URL", "https://docs.supremainc.com"),
+        description="Base URL for BioStar X documentation"
+    )
+    docs_cache_ttl: int = Field(
+        default_factory=lambda: int(os.getenv("DOCS_CACHE_TTL", "3600")),
+        description="Documentation cache TTL in seconds"
+    )
+
+    class Config:
+        env_file = ".env"
+        env_file_encoding = "utf-8"
+
+    def validate_required(self) -> list[str]:
+        """Validate required configuration and return list of errors."""
+        errors = []
+
+        if not self.biostar_url:
+            errors.append("BIOSTAR_URL is required")
+        if not self.biostar_username:
+            errors.append("BIOSTAR_USERNAME is required")
+        if not self.biostar_password:
+            errors.append("BIOSTAR_PASSWORD is required")
+
+        return errors

biostar_x_mcp_server/handlers/__init__.py

@@ -0,0 +1,35 @@
+"""
+BioStar X MCP Server Handlers
+All API handlers for BioStar X integration
+"""
+from .base_handler import BaseHandler
+from .auth_handler import AuthHandler
+from .user_handler import UserHandler
+from .door_handler import DoorHandler
+from .access_handler import AccessHandler
+from .device_handler import DeviceHandler
+from .event_handler import EventHandler
+from .audit_handler import AuditHandler
+from .card_handler import CardsHandler
+from .navigation_handler import NavigationHandler
+from .file_handler import FileHandler
+from .log_handler import LogHandler
+from .occupancy_handler import OccupancyHandler
+from .help_web_handler import HelpWebHandler
+
+__all__ = [
+    "BaseHandler",
+    "AuthHandler",
+    "UserHandler",
+    "DoorHandler",
+    "AccessHandler",
+    "DeviceHandler",
+    "EventHandler",
+    "AuditHandler",
+    "CardsHandler",
+    "NavigationHandler",
+    "FileHandler",
+    "LogHandler",
+    "OccupancyHandler",
+    "HelpWebHandler"
+]