Update logging

examples/weather.py

@@ -6,6 +6,7 @@ import os
 import httpx
 from pydantic import BaseModel, Field
 from fastmcp.server import FastMCP
+from fastmcp.utilities.logging import configure_logging
 
 # Load env vars
 API_KEY = os.getenv("OPENWEATHER_API_KEY")
@@ -117,13 +118,9 @@ app.add_dir_resource(
 
 def main():
     import asyncio
-    import logging
 
     # Configure logging
-    logging.basicConfig(
-        level=logging.INFO,
-        format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
-    )
+    configure_logging(level="INFO")
 
     # Run the server
     asyncio.run(FastMCP.run_stdio(app))

src/fastmcp/cli.py

@@ -1,15 +1,15 @@
 """FastMCP CLI tools."""
 
 import importlib.metadata
-import logging
 import subprocess
 import sys
 from pathlib import Path
 
 import typer
 
-# Configure logging
-logger = logging.getLogger("mcp")
+from .utilities.logging import get_logger
+
+logger = get_logger(__name__)
 
 app = typer.Typer(
     name="fastmcp",

src/fastmcp/resources.py

@@ -3,7 +3,6 @@
 import abc
 import asyncio
 import json
-import logging
 from pathlib import Path
 from typing import Dict, Optional, Callable, Any
 from urllib.parse import parse_qs, urlparse
@@ -11,7 +10,9 @@ from urllib.parse import parse_qs, urlparse
 import httpx
 from pydantic import BaseModel, field_validator
 
-logger = logging.getLogger("mcp")
+from .utilities.logging import get_logger
+
+logger = get_logger(__name__)
 
 
 class Resource(BaseModel):

src/fastmcp/server.py

@@ -1,11 +1,8 @@
 """FastMCP - A more ergonomic interface for MCP servers."""
 
-import asyncio
 import base64
 import functools
 import json
-import logging
-from dataclasses import dataclass
 from typing import Any, Callable, Dict, Optional, Sequence, Union, Literal
 
 from mcp.server import Server as MCPServer
@@ -19,7 +16,7 @@ from pydantic_settings import BaseSettings
 from .exceptions import ResourceError
 from .resources import Resource, FunctionResource, ResourceManager
 from .tools import ToolManager
-from .utilities import get_logger, configure_logging
+from .utilities.logging import get_logger, configure_logging
 
 logger = get_logger(__name__)
 

src/fastmcp/tools.py

@@ -6,9 +6,9 @@ from typing import Any, Callable, Dict, Optional
 from pydantic import BaseModel, Field, TypeAdapter
 
 from .exceptions import ToolError
-import logging
+from .utilities.logging import get_logger
 
-logger = logging.getLogger("fastmcp")
+logger = get_logger(__name__)
 
 
 class Tool(BaseModel):
@@ -84,7 +84,7 @@ class ToolManager:
         existing = self._tools.get(tool.name)
         if existing:
             if self.warn_on_duplicate_tools:
-                logging.warning(f"Tool already exists: {tool.name}")
+                logger.warning(f"Tool already exists: {tool.name}")
             return existing
         self._tools[tool.name] = tool
         return tool

src/fastmcp/utilities/__init__.py

@@ -1,4 +1 @@
-"""Utility functions for FastMCP."""
-from .logging import get_logger, configure_logging
-
-__all__ = ["get_logger", "configure_logging"]
+"""FastMCP utility modules."""

src/fastmcp/utilities/logging.py

@@ -1,33 +1,30 @@
 """Logging utilities for FastMCP."""
+
 import logging
-from typing import Optional
+from typing import Literal
 
 
-def get_logger(name: Optional[str] = None) -> logging.Logger:
-    """Get a logger instance nested under the FastMCP namespace.
-    
+def get_logger(name: str) -> logging.Logger:
+    """Get a logger nested under FastMCP namespace.
+
     Args:
-        name: Optional name to append to the FastMCP namespace.
-            If provided, the logger will be named 'FastMCP.[name]'.
-            If not provided, returns the root FastMCP logger.
-    
+        name: The name of the logger, which will be prefixed with 'FastMCP.'
+
     Returns:
         A configured logger instance
     """
-    logger_name = "FastMCP"
-    if name:
-        logger_name = f"{logger_name}.{name}"
-    return logging.getLogger(logger_name)
+    return logging.getLogger(f"FastMCP.{name}")
 
 
-def configure_logging(level: str = "INFO") -> None:
-    """Configure the root FastMCP logger.
-    
+def configure_logging(
+    level: Literal["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"] = "INFO",
+) -> None:
+    """Configure logging for FastMCP.
+
     Args:
-        level: The log level to use. Defaults to INFO.
+        level: The log level to use
     """
     logging.basicConfig(
-        level=getattr(logging, level.upper()),
+        level=level,
         format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
     )
-    get_logger().setLevel(getattr(logging, level.upper()))