fastmcp 2.1.1__tar.gz → 2.1.2__tar.gz

{fastmcp-2.1.1 → fastmcp-2.1.2}/.github/workflows/run-static.yml

@@ -8,7 +8,19 @@ env:
 on:
   push:
     branches: ["main"]
+    paths:
+      - "src/**"
+      - "tests/**"
+      - "uv.lock"
+      - "pyproject.toml"
+      - ".github/workflows/**"
   pull_request:
+    paths:
+      - "src/**"
+      - "tests/**"
+      - "uv.lock"
+      - "pyproject.toml"
+      - ".github/workflows/**"
   workflow_dispatch:
 
 permissions:

{fastmcp-2.1.1 → fastmcp-2.1.2}/PKG-INFO

@@ -1,10 +1,21 @@
 Metadata-Version: 2.4
 Name: fastmcp
-Version: 2.1.1
+Version: 2.1.2
 Summary: The fast, Pythonic way to build MCP servers.
+Project-URL: Homepage, https://gofastmcp.com
+Project-URL: Repository, https://github.com/jlowin/fastmcp
+Project-URL: Documentation, https://gofastmcp.com
 Author: Jeremiah Lowin
-License: Apache-2.0
+License-Expression: Apache-2.0
 License-File: LICENSE
+Keywords: agent,fastmcp,llm,mcp,mcp client,mcp server,model context protocol
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Requires-Dist: dotenv>=0.9.9
 Requires-Dist: fastapi>=0.115.12
@@ -26,6 +37,7 @@ Description-Content-Type: text/markdown
 [![Tests](https://github.com/jlowin/fastmcp/actions/workflows/run-tests.yml/badge.svg)](https://github.com/jlowin/fastmcp/actions/workflows/run-tests.yml)
 [![License](https://img.shields.io/github/license/jlowin/fastmcp.svg)](https://github.com/jlowin/fastmcp/blob/main/LICENSE)
 
+<a href="https://trendshift.io/repositories/13266" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13266" alt="jlowin%2Ffastmcp | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
 </div>
 
 The [Model Context Protocol (MCP)](https://modelcontextprotocol.io) is a new, standardized way to provide context and tools to your LLMs, and FastMCP makes building MCP servers and clients simple and intuitive. Create tools, expose resources, define prompts, and connect components with clean, Pythonic code.
@@ -787,4 +799,4 @@ We use `ruff` via `pre-commit`.
 
 Please open an issue or discussion for questions or suggestions!
 
-</details>
+</details>

{fastmcp-2.1.1 → fastmcp-2.1.2}/README.md

@@ -9,6 +9,7 @@
 [![Tests](https://github.com/jlowin/fastmcp/actions/workflows/run-tests.yml/badge.svg)](https://github.com/jlowin/fastmcp/actions/workflows/run-tests.yml)
 [![License](https://img.shields.io/github/license/jlowin/fastmcp.svg)](https://github.com/jlowin/fastmcp/blob/main/LICENSE)
 
+<a href="https://trendshift.io/repositories/13266" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13266" alt="jlowin%2Ffastmcp | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
 </div>
 
 The [Model Context Protocol (MCP)](https://modelcontextprotocol.io) is a new, standardized way to provide context and tools to your LLMs, and FastMCP makes building MCP servers and clients simple and intuitive. Create tools, expose resources, define prompts, and connect components with clean, Pythonic code.
@@ -770,4 +771,4 @@ We use `ruff` via `pre-commit`.
 
 Please open an issue or discussion for questions or suggestions!
 
-</details>
+</details>

{fastmcp-2.1.1 → fastmcp-2.1.2}/docs/getting-started/quickstart.mdx

@@ -5,7 +5,7 @@ icon: rocket
 
 Welcome! This guide will help you quickly set up FastMCP and run your first MCP server.
 
-If you haven't already installed FastMCP, follow the [installation instructions](/docs/getting-started/installation).
+If you haven't already installed FastMCP, follow the [installation instructions](/getting-started/installation).
 
 ## Creating a FastMCP Server
 
@@ -123,5 +123,5 @@ fastmcp run my_server.py:mcp
 Note that FastMCP *does not* require the `__main__` block in the server file, and will ignore it if it is present. Instead, it looks for the server object provided in the CLI command (here, `mcp`). If no server object is provided, `fastmcp run` will automatically search for servers called "mcp", "app", or "server" in the file.
 
 <Tip>
-We pointed our client at the server file, which is recognized as a Python MCP server and executed with `python my_server.py` by default. This exceutes the `__main__` block of the server file. There are other ways to run the server, which are described in the [server configuration](/docs/getting-started/configuration) guide.
+We pointed our client at the server file, which is recognized as a Python MCP server and executed with `python my_server.py` by default. This exceutes the `__main__` block of the server file. There are other ways to run the server, which are described in the [server configuration](/servers/fastmcp#running-the-server) guide.
 </Tip>

{fastmcp-2.1.1 → fastmcp-2.1.2}/docs/servers/context.mdx

@@ -5,7 +5,7 @@ description: Access MCP capabilities like logging, progress, and resources withi
 icon: rectangle-code
 ---
 
-When defining FastMCP [Tools](/server/tools), your functions might need to interact with the underlying MCP session or access server capabilities. FastMCP provides the `Context` object for this purpose.
+When defining FastMCP [tools](/servers/tools), your functions might need to interact with the underlying MCP session or access server capabilities. FastMCP provides the `Context` object for this purpose.
 
 ## What Is Context?
 
@@ -227,7 +227,7 @@ async def generate_example(concept: str, ctx: Context) -> str:
     return f"```python\n{code_example}\n```"
 ```
 
-See [Client Sampling](/client/sampling) for more details on how clients handle these requests.
+See [Client Sampling](/clients/overview#llm-sampling) for more details on how clients handle these requests.
 
 ### Request Information
 

{fastmcp-2.1.1 → fastmcp-2.1.2}/docs/servers/fastmcp.mdx

@@ -28,9 +28,9 @@ The `FastMCP` constructor accepts several arguments:
 
 *   `name`: (Optional) A human-readable name for your server. Defaults to "FastMCP".
 *   `instructions`: (Optional) Description of how to interact with this server. These instructions help clients understand the server's purpose and available functionality.
-*   `lifespan`: (Optional) An async context manager function for server startup and shutdown logic. See [Lifespan Management](/advanced/lifespan).
+*   `lifespan`: (Optional) An async context manager function for server startup and shutdown logic.
 *   `tags`: (Optional) A set of strings to tag the server itself.
-*   `**settings`: Keyword arguments corresponding to `ServerSettings` for configuration. See [Configuration](/advanced/configuration).
+*   `**settings`: Keyword arguments corresponding to additional `ServerSettings` configuration
 
 ## Components
 
@@ -47,7 +47,7 @@ def multiply(a: float, b: float) -> float:
     return a * b
 ```
 
-See [Tools](/server/tools) for detailed documentation.
+See [Tools](/servers/tools) for detailed documentation.
 
 ### Resources
 
@@ -60,7 +60,7 @@ def get_config() -> dict:
     return {"theme": "dark", "version": "1.0"}
 ```
 
-See [Resources & Templates](/server/resources) for detailed documentation.
+See [Resources & Templates](/servers/resources) for detailed documentation.
 
 ### Resource Templates
 
@@ -74,7 +74,7 @@ def get_user_profile(user_id: int) -> dict:
     return {"id": user_id, "name": f"User {user_id}", "status": "active"}
 ```
 
-See [Resources & Templates](/server/resources) for detailed documentation.
+See [Resources & Templates](/servers/resources) for detailed documentation.
 
 ### Prompts
 
@@ -88,7 +88,7 @@ def analyze_data(data_points: list[float]) -> str:
     return f"Please analyze these data points: {formatted_data}"
 ```
 
-See [Prompts](/server/prompts) for detailed documentation.
+See [Prompts](/servers/prompts) for detailed documentation.
 
 ## Running the Server
 
@@ -186,9 +186,6 @@ fastmcp run my_server.py:mcp --transport sse --host 127.0.0.1 --port 8888
 
 The CLI can dynamically find and run FastMCP server objects in your files, but including the `if __name__ == "__main__":` block ensures compatibility with all clients.
 
-<Tip>
-For more options, including how to set up your server's dependencies or use advanced configurations, see the [CLI Reference](/cli/overview).
-</Tip>
 
 ## Mounting Subservers
 
@@ -299,4 +296,3 @@ print(mcp.settings.on_duplicate_tools) # Output: DuplicateBehavior.ERROR
 
 All of these can be configured directly as parameters when creating the `FastMCP` instance.
 
-See the [Configuration](/advanced/configuration) page for more details. 

{fastmcp-2.1.1 → fastmcp-2.1.2}/docs/servers/prompts.mdx

@@ -195,7 +195,7 @@ Using the `ctx` parameter (based on its `Context` type hint), you can access:
 -   **LLM Sampling:** `ctx.sample(...)`
 -   **Request Info:** `ctx.request_id`, `ctx.client_id`
 
-Refer to the [Using Context](/server/context) page for more details on these capabilities.
+Refer to the [Context documentation](/servers/context) for more details on these capabilities.
 
 ## Server Behavior
 

{fastmcp-2.1.1 → fastmcp-2.1.2}/docs/servers/tools.mdx

@@ -300,7 +300,7 @@ The Context object provides access to:
 - **LLM Sampling**: `ctx.sample(...)`
 - **Request Information**: `ctx.request_id`, `ctx.client_id`
 
-For full documentation on the Context object and all its capabilities, see the [Context Object](/server/context) page.
+For full documentation on the Context object and all its capabilities, see the [Context documentation](/servers/context).
 
 ## Server Behavior
 

{fastmcp-2.1.1 → fastmcp-2.1.2}/pyproject.toml

@@ -14,7 +14,26 @@ dependencies = [
 ]
 requires-python = ">=3.10"
 readme = "README.md"
-license = { text = "Apache-2.0" }
+license = "Apache-2.0"
+
+keywords = [
+    "mcp",
+    "mcp server",
+    "mcp client",
+    "model context protocol",
+    "fastmcp",
+    "llm",
+    "agent",
+]
+classifiers = [
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Typing :: Typed",
+]
 
 [dependency-groups]
 dev = [
@@ -34,6 +53,11 @@ dev = [
 [project.scripts]
 fastmcp = "fastmcp.cli:app"
 
+[project.urls]
+Homepage = "https://gofastmcp.com"
+Repository = "https://github.com/jlowin/fastmcp"
+Documentation = "https://gofastmcp.com"
+
 [build-system]
 requires = ["hatchling", "uv-dynamic-versioning>=0.7.0"]
 build-backend = "hatchling.build"

{fastmcp-2.1.1 → fastmcp-2.1.2}/src/fastmcp/prompts/prompt.py

@@ -8,7 +8,6 @@ from typing import Annotated, Any, Literal
 import pydantic_core
 from mcp.types import EmbeddedResource, ImageContent, TextContent
 from pydantic import BaseModel, BeforeValidator, Field, TypeAdapter, validate_call
-from typing_extensions import Self
 
 from fastmcp.utilities.types import _convert_set_defaults
 
@@ -163,13 +162,6 @@ class Prompt(BaseModel):
         except Exception as e:
             raise ValueError(f"Error rendering prompt {self.name}: {e}")
 
-    def copy(self, updates: dict[str, Any] | None = None) -> Self:
-        """Copy the prompt with optional updates."""
-        data = self.model_dump()
-        if updates:
-            data.update(updates)
-        return type(self)(**data)
-
     def __eq__(self, other: object) -> bool:
         if not isinstance(other, Prompt):
             return False

{fastmcp-2.1.1 → fastmcp-2.1.2}/src/fastmcp/prompts/prompt_manager.py

@@ -1,5 +1,6 @@
 """Prompt management functionality."""
 
+import copy
 from collections.abc import Awaitable, Callable
 from typing import Any
 
@@ -84,7 +85,8 @@ class PromptManager:
             # Create prefixed name
             prefixed_name = f"{prefix}{name}" if prefix else name
 
-            new_prompt = prompt.copy(updates=dict(name=prefixed_name))
+            new_prompt = copy.copy(prompt)
+            new_prompt.name = prefixed_name
 
             # Store the prompt with the prefixed name
             self.add_prompt(new_prompt)

{fastmcp-2.1.1 → fastmcp-2.1.2}/src/fastmcp/resources/resource.py

@@ -1,7 +1,7 @@
 """Base classes and interfaces for FastMCP resources."""
 
 import abc
-from typing import Annotated, Any
+from typing import Annotated
 
 from pydantic import (
     AnyUrl,
@@ -13,7 +13,6 @@ from pydantic import (
     ValidationInfo,
     field_validator,
 )
-from typing_extensions import Self
 
 from fastmcp.utilities.types import _convert_set_defaults
 
@@ -54,13 +53,6 @@ class Resource(BaseModel, abc.ABC):
         """Read the resource content."""
         pass
 
-    def copy(self, updates: dict[str, Any] | None = None) -> Self:
-        """Copy the resource with optional updates."""
-        data = self.model_dump()
-        if updates:
-            data.update(updates)
-        return type(self)(**data)
-
     def __eq__(self, other: object) -> bool:
         if not isinstance(other, Resource):
             return False

{fastmcp-2.1.1 → fastmcp-2.1.2}/src/fastmcp/resources/resource_manager.py

@@ -1,5 +1,6 @@
 """Resource manager functionality."""
 
+import copy
 import inspect
 import re
 from collections.abc import Callable
@@ -238,7 +239,8 @@ class ResourceManager:
             # Create prefixed URI and copy the resource with the new URI
             prefixed_uri = f"{prefix}{uri}" if prefix else uri
 
-            new_resource = resource.copy(updates=dict(uri=prefixed_uri))
+            new_resource = copy.copy(resource)
+            new_resource.uri = AnyUrl(prefixed_uri)
 
             # Store directly in resources dictionary
             self.add_resource(new_resource)
@@ -266,9 +268,8 @@ class ResourceManager:
                 f"{prefix}{uri_template}" if prefix else uri_template
             )
 
-            new_template = template.copy(
-                updates=dict(uri_template=prefixed_uri_template)
-            )
+            new_template = copy.copy(template)
+            new_template.uri_template = prefixed_uri_template
 
             # Store directly in templates dictionary
             self.add_template(new_template)

{fastmcp-2.1.1 → fastmcp-2.1.2}/src/fastmcp/resources/template.py

@@ -8,7 +8,6 @@ from collections.abc import Callable
 from typing import Annotated, Any
 
 from pydantic import BaseModel, BeforeValidator, Field, TypeAdapter, validate_call
-from typing_extensions import Self
 
 from fastmcp.resources.types import FunctionResource, Resource
 from fastmcp.utilities.types import _convert_set_defaults
@@ -92,13 +91,6 @@ class ResourceTemplate(BaseModel):
         except Exception as e:
             raise ValueError(f"Error creating resource from template: {e}")
 
-    def copy(self, updates: dict[str, Any] | None = None) -> Self:
-        """Copy the resource template with optional updates."""
-        data = self.model_dump()
-        if updates:
-            data.update(updates)
-        return type(self)(**data)
-
     def __eq__(self, other: object) -> bool:
         if not isinstance(other, ResourceTemplate):
             return False

{fastmcp-2.1.1 → fastmcp-2.1.2}/src/fastmcp/tools/tool.py

@@ -5,7 +5,6 @@ from collections.abc import Callable
 from typing import TYPE_CHECKING, Annotated, Any
 
 from pydantic import BaseModel, BeforeValidator, Field
-from typing_extensions import Self
 
 from fastmcp.exceptions import ToolError
 from fastmcp.utilities.func_metadata import FuncMetadata, func_metadata
@@ -102,13 +101,6 @@ class Tool(BaseModel):
         except Exception as e:
             raise ToolError(f"Error executing tool {self.name}: {e}") from e
 
-    def copy(self, updates: dict[str, Any] | None = None) -> Self:
-        """Copy the tool with optional updates."""
-        data = self.model_dump()
-        if updates:
-            data.update(updates)
-        return type(self)(**data)
-
     def __eq__(self, other: object) -> bool:
         if not isinstance(other, Tool):
             return False

{fastmcp-2.1.1 → fastmcp-2.1.2}/src/fastmcp/tools/tool_manager.py

@@ -1,5 +1,6 @@
 from __future__ import annotations as _annotations
 
+import copy
 from collections.abc import Callable
 from typing import TYPE_CHECKING, Any
 
@@ -90,7 +91,9 @@ class ToolManager:
         for name, tool in tool_manager._tools.items():
             prefixed_name = f"{prefix}{name}" if prefix else name
 
-            new_tool = tool.copy(updates=dict(name=prefixed_name))
+            new_tool = copy.copy(tool)
+            new_tool.name = prefixed_name
+
             # Store the copied tool
             self.add_tool(new_tool)
             logger.debug(f'Imported tool "{name}" as "{prefixed_name}"')

{fastmcp-2.1.1 → fastmcp-2.1.2}/src/fastmcp/utilities/logging.py

@@ -20,15 +20,23 @@ def get_logger(name: str) -> logging.Logger:
 
 
 def configure_logging(
-    level: Literal["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"] = "INFO",
+    level: Literal["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"] | int = "INFO",
 ) -> None:
     """Configure logging for FastMCP.
 
     Args:
         level: the log level to use
     """
-    logging.basicConfig(
-        level=level,
-        format="%(message)s",
-        handlers=[RichHandler(console=Console(stderr=True), rich_tracebacks=True)],
-    )
+    # Only configure the FastMCP logger namespace
+    handler = RichHandler(console=Console(stderr=True), rich_tracebacks=True)
+    formatter = logging.Formatter("%(message)s")
+    handler.setFormatter(formatter)
+
+    fastmcp_logger = logging.getLogger("FastMCP")
+    fastmcp_logger.setLevel(level)
+
+    # Remove any existing handlers to avoid duplicates on reconfiguration
+    for hdlr in fastmcp_logger.handlers[:]:
+        fastmcp_logger.removeHandler(hdlr)
+
+    fastmcp_logger.addHandler(handler)

{fastmcp-2.1.1 → fastmcp-2.1.2}/src/fastmcp/utilities/openapi.py

@@ -150,93 +150,6 @@ def _resolve_ref(
     return item
 
 
-def _extract_schema_as_dict(
-    schema_obj: Schema | Reference, openapi: OpenAPI
-) -> JsonSchema:
-    """Resolves a schema/reference and returns it as a dictionary."""
-    resolved_schema = _resolve_ref(schema_obj, openapi)
-    if isinstance(resolved_schema, Schema):
-        # Using exclude_none=True might be better than exclude_unset sometimes
-        return resolved_schema.model_dump(mode="json", by_alias=True, exclude_none=True)
-    elif isinstance(resolved_schema, dict):
-        logger.warning(
-            "Resolved schema reference resulted in a dict, not a Schema model."
-        )
-        return resolved_schema
-    else:
-        ref_str = getattr(schema_obj, "ref", "unknown")
-        logger.warning(
-            f"Expected Schema after resolving ref '{ref_str}', got {type(resolved_schema)}. Returning empty dict."
-        )
-        return {}
-
-
-def _convert_to_parameter_location(param_in: str) -> ParameterLocation:
-    """Convert string parameter location to our ParameterLocation type."""
-    if param_in == "path":
-        return "path"
-    elif param_in == "query":
-        return "query"
-    elif param_in == "header":
-        return "header"
-    elif param_in == "cookie":
-        return "cookie"
-    else:
-        logger.warning(f"Unknown parameter location: {param_in}, defaulting to 'query'")
-        return "query"
-
-
-def _extract_responses(
-    operation_responses: dict[str, Response | Reference] | None,
-    openapi: OpenAPI,
-) -> dict[str, ResponseInfo]:
-    """Extracts and resolves response information for an operation."""
-    extracted_responses: dict[str, ResponseInfo] = {}
-    if not operation_responses:
-        return extracted_responses
-
-    for status_code, resp_or_ref in operation_responses.items():
-        try:
-            response = cast(Response, _resolve_ref(resp_or_ref, openapi))
-            if not isinstance(response, Response):
-                ref_str = getattr(resp_or_ref, "ref", "unknown")
-                logger.warning(
-                    f"Expected Response after resolving ref '{ref_str}' for status code {status_code}, got {type(response)}. Skipping."
-                )
-                continue
-
-            content_schemas: dict[str, JsonSchema] = {}
-            if response.content:
-                for media_type_str, media_type_obj in response.content.items():
-                    if (
-                        isinstance(media_type_obj, MediaType)
-                        and media_type_obj.media_type_schema
-                    ):
-                        try:
-                            schema_dict = _extract_schema_as_dict(
-                                media_type_obj.media_type_schema, openapi
-                            )
-                            content_schemas[media_type_str] = schema_dict
-                        except ValueError as schema_err:
-                            logger.error(
-                                f"Failed to extract schema for media type '{media_type_str}' in response {status_code}: {schema_err}"
-                            )
-
-            resp_info = ResponseInfo(
-                description=response.description, content_schema=content_schemas
-            )
-            extracted_responses[str(status_code)] = resp_info
-
-        except (ValidationError, ValueError, AttributeError) as e:
-            ref_name = getattr(resp_or_ref, "ref", "unknown")
-            logger.error(
-                f"Failed to extract response for status code {status_code} (ref: '{ref_name}'): {e}",
-                exc_info=False,
-            )
-
-    return extracted_responses
-
-
 # --- Main Parsing Function ---
 # (No changes needed in the main loop logic, only in the helpers it calls)
 def parse_openapi_to_http_routes(openapi_dict: dict[str, Any]) -> list[HTTPRoute]: