feat: configuration & logging

Author: Jimdrews

.env.example.local

@@ -0,0 +1 @@
+ENVIRONMENT="local"

.env.example.production

@@ -0,0 +1,2 @@
+ENVIRONMENT="production"
+BASE_URL="https://your-url-here.com/

mcp_server/logging.py

@@ -0,0 +1,15 @@
+import logging
+
+from .settings import auto_config as cfg
+
+if not cfg:
+    raise RuntimeError(
+        "configuration is not set. Please set the ENVIRONMENT environment variable."
+    )
+
+
+logging.basicConfig(
+    level=getattr(logging, cfg.LOG_LEVEL.upper()), format=cfg.LOG_FORMAT
+)
+
+logger = logging.getLogger(cfg.MCP_SERVER_NAME)

mcp_server/main.py

@@ -1,3 +1,16 @@
 from mcp.server.fastmcp import FastMCP
 
-mcp = FastMCP()
+from .logging import logger
+from .settings import auto_config as cfg
+
+if not cfg:
+    raise RuntimeError(
+        "configuration is not set. Please set the ENVIRONMENT environment variable."
+    )
+
+mcp = FastMCP(name=cfg.MCP_SERVER_NAME)
+
+logger.info(f"Starting {cfg.MCP_SERVER_NAME} v{cfg.MCP_SERVER_VERSION}")
+logger.debug(f"Debug mode: {cfg.DEBUG}")
+logger.info(f"Base URL: {cfg.BASE_URL}")
+logger.debug(f"Log level: {cfg.LOG_LEVEL}")

mcp_server/settings/__init__.py

@@ -0,0 +1,22 @@
+import os
+
+from .config import Common, Local, Production, Staging
+
+environment: str | None = os.getenv("ENVIRONMENT", None)
+
+if not environment:
+    raise EnvironmentError("ENVIRONMENT environment variable is not set!")
+
+auto_config: type[Common] | None = None
+if environment == "local":
+    auto_config = Local
+elif environment == "staging":
+    auto_config = Staging
+elif environment == "production":
+    auto_config = Production
+
+
+if not auto_config:
+    raise RuntimeError(
+        "Configuration is not set. Please set the ENVIRONMENT environment variable."
+    )

mcp_server/settings/config.py

@@ -0,0 +1,41 @@
+import os
+
+
+class Common:
+    """Base configuration class with common settings"""
+
+    # MCP Server Settings
+    MCP_SERVER_NAME: str = "mcp-production"
+    MCP_SERVER_VERSION: str = "0.1.0"
+
+    # Application Settings
+    DEBUG: bool = False
+    BASE_URL: str = "http://localhost:8000"
+
+    # Logging
+    LOG_LEVEL: str = "INFO"
+    LOG_FORMAT: str = "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
+
+
+class Local(Common):
+    """Local development configuration"""
+
+    DEBUG: bool = True
+    LOG_LEVEL: str = os.getenv("SERVER_LOG_LEVEL", "DEBUG")
+    BASE_URL: str = "http://localhost:8000"
+
+
+class Production(Common):
+    """Production configuration"""
+
+    DEBUG: bool = False
+    LOG_LEVEL: str = os.getenv("SERVER_LOG_LEVEL", "WARNING")
+    BASE_URL: str = os.getenv("PRODUCTION_BASE_URL", "https://api.production.com")
+
+
+class Staging(Production):
+    """Staging configuration - inherits from Production but with debug enabled"""
+
+    DEBUG: bool = True
+    LOG_LEVEL: str = os.getenv("SERVER_LOG_LEVEL", "INFO")
+    BASE_URL: str = os.getenv("STAGING_BASE_URL", "https://api.staging.com")