π The fast, Pythonic way to build MCP servers and clients.
Rename server
Jeremiah Lowinead41caa0df7
diff --git a/examples/desktop.py b/examples/desktop.pyindex b8953e2e4..245cba5d7 100644--- a/examples/desktop.py+++ b/examples/desktop.py@@ -7,10 +7,10 @@ A simple example that exposes the desktop directory as a resource.import asynciofrom pathlib import Path-from fastmcp.server import FastMCPServer+from fastmcp.server import FastMCP# Create server-app = FastMCPServer("desktop")+app = FastMCP("desktop")# Add desktop as a directory resourcedesktop = Path.home() / "Desktop"@@ -24,7 +24,7 @@ app.add_dir_resource(def main123():# Run the server- asyncio.run(FastMCPServer.run_stdio(app))+ asyncio.run(FastMCP.run_stdio(app))if __name__ == "__main__":diff --git a/examples/weather.py b/examples/weather.pyindex 10593e31f..0a53a152d 100644--- a/examples/weather.py+++ b/examples/weather.py@@ -5,7 +5,7 @@ FastMCP Weather Server Exampleimport osimport httpxfrom pydantic import BaseModel, Field-from fastmcp.server import FastMCPServer+from fastmcp.server import FastMCP# Load env varsAPI_KEY = os.getenv("OPENWEATHER_API_KEY")@@ -32,7 +32,7 @@ class AlertParams(BaseModel):# Create server-app = FastMCPServer("weather-service")+app = FastMCP("weather-service")# Tools using Pydantic models@@ -126,7 +126,7 @@ def main():)# Run the server- asyncio.run(FastMCPServer.run_stdio(app))+ asyncio.run(FastMCP.run_stdio(app))if __name__ == "__main__":diff --git a/src/fastmcp/__init__.py b/src/fastmcp/__init__.pynew file mode 100644index 000000000..d6507801f--- /dev/null+++ b/src/fastmcp/__init__.py@@ -0,0 +1 @@+from .server import FastMCP\ No newline at end of filediff --git a/src/fastmcp/server.py b/src/fastmcp/server.pyindex 125e766a0..06e2bc7dd 100644--- a/src/fastmcp/server.py+++ b/src/fastmcp/server.py@@ -1,13 +1,16 @@"""FastMCP - A more ergonomic interface for MCP servers."""+import asyncioimport base64import functoolsimport jsonimport logging+from dataclasses import dataclassfrom typing import Any, Callable, Dict, Optional, Sequence, Union, Literalfrom mcp.server import Server as MCPServerfrom mcp.server.stdio import stdio_server+from mcp.server.sse import SseServerTransportfrom mcp.types import Resource as MCPResourcefrom mcp.types import Tool, TextContent, ImageContent, EmbeddedResourcefrom pydantic import BaseModel@@ -16,9 +19,9 @@ from pydantic_settings import BaseSettingsfrom .exceptions import ResourceErrorfrom .resources import Resource, FunctionResource, ResourceManagerfrom .tools import ToolManager+from .utilities import get_logger, configure_logging--logger = logging.getLogger("fastmcp")+logger = get_logger(__name__)class Settings(BaseSettings):@@ -45,10 +48,10 @@ class Settings(BaseSettings):warn_on_duplicate_tools: bool = True-class FastMCPServer:+class FastMCP:def __init__(self, name=None, **settings: Optional[Settings]):self.settings = Settings(**settings)- self._mcp_server = MCPServer(name=name or "FastMCPServer")+ self._mcp_server = MCPServer(name=name or "FastMCP")self._tool_manager = ToolManager(warn_on_duplicate_tools=self.settings.warn_on_duplicate_tools)@@ -57,11 +60,7 @@ class FastMCPServer:)# Configure logging- logging.basicConfig(- level=getattr(logging, self.settings.log_level.upper()),- format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",- )- logger.setLevel(getattr(logging, self.settings.log_level.upper()))+ configure_logging(self.settings.log_level)self._setup_handlers()@@ -297,7 +296,7 @@ class FastMCPServer:await self._mcp_server.run(*args, **kwargs)@classmethod- async def run_stdio(cls, app: "FastMCPServer") -> None:+ async def run_stdio(cls, app: "FastMCP") -> None:"""Run the server using stdio transport."""async with stdio_server() as (read_stream, write_stream):await app.run(@@ -309,7 +308,7 @@ class FastMCPServer:@classmethodasync def run_sse(cls,- app: "FastMCPServer",+ app: "FastMCP",) -> None:"""Run the server using SSE transport."""from mcp.server.sse import SseServerTransportdiff --git a/src/fastmcp/utilities/__init__.py b/src/fastmcp/utilities/__init__.pynew file mode 100644index 000000000..a943cff70--- /dev/null+++ b/src/fastmcp/utilities/__init__.py@@ -0,0 +1,4 @@+"""Utility functions for FastMCP."""+from .logging import get_logger, configure_logging++__all__ = ["get_logger", "configure_logging"]diff --git a/src/fastmcp/utilities/logging.py b/src/fastmcp/utilities/logging.pynew file mode 100644index 000000000..5a3656ccb--- /dev/null+++ b/src/fastmcp/utilities/logging.py@@ -0,0 +1,33 @@+"""Logging utilities for FastMCP."""+import logging+from typing import Optional+++def get_logger(name: Optional[str] = None) -> logging.Logger:+ """Get a logger instance nested under the 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.++ Returns:+ A configured logger instance+ """+ logger_name = "FastMCP"+ if name:+ logger_name = f"{logger_name}.{name}"+ return logging.getLogger(logger_name)+++def configure_logging(level: str = "INFO") -> None:+ """Configure the root FastMCP logger.++ Args:+ level: The log level to use. Defaults to INFO.+ """+ logging.basicConfig(+ level=getattr(logging, level.upper()),+ format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",+ )+ get_logger().setLevel(getattr(logging, level.upper()))diff --git a/tests/test_server.py b/tests/test_server.pyindex 5ab03b989..cd049d5d8 100644--- a/tests/test_server.py+++ b/tests/test_server.py@@ -1,13 +1,13 @@from mcp.shared.memory import (create_connected_server_and_client_session as client_session,)-from fastmcp.server import FastMCPServer+from fastmcp.server import FastMCPclass TestServer:async def test_create_server(self):- server = FastMCPServer()- assert server.name == "FastMCPServer"+ server = FastMCP()+ assert server.name == "FastMCP"def tool_fn(x: int, y: int) -> int:@@ -16,20 +16,20 @@ def tool_fn(x: int, y: int) -> int:class TestServerTools:async def test_add_tool(self):- server = FastMCPServer()+ server = FastMCP()server.add_tool(tool_fn)server.add_tool(tool_fn)assert len(server._tool_manager.list_tools()) == 1async def test_list_tools(self):- server = FastMCPServer()+ server = FastMCP()server.add_tool(tool_fn)async with client_session(server._mcp_server) as client:tools = await client.list_tools()assert len(tools.tools) == 1async def test_call_tool(self):- server = FastMCPServer()+ server = FastMCP()server.add_tool(tool_fn)async with client_session(server._mcp_server) as client:result = await client.call_tool("my_tool", {"arg1": "value"})