From 31f96876062ff09a8178ee2a23b18b2295225b1f Mon Sep 17 00:00:00 2001
From: Jeremiah Lowin <153965+jlowin@users.noreply.github.com>
Date: Wed, 13 Aug 2025 20:52:05 -0400
Subject: [PATCH 1/2] Remove unnecessary asserts (#1484)
---
.github/workflows/run-static.yml | 1 +
docs/python-sdk/fastmcp-cli-run.mdx | 12 +++---
docs/python-sdk/fastmcp-server-auth-auth.mdx | 10 ++---
docs/python-sdk/fastmcp-server-context.mdx | 42 +++++++++----------
.../fastmcp-utilities-components.mdx | 14 +++----
src/fastmcp/cli/run.py | 5 ---
.../experimental/server/openapi/routing.py | 2 -
.../experimental/server/openapi/server.py | 2 -
src/fastmcp/server/auth/auth.py | 3 +-
src/fastmcp/server/context.py | 3 +-
src/fastmcp/utilities/components.py | 3 +-
src/fastmcp/utilities/json_schema_type.py | 6 ++-
12 files changed, 50 insertions(+), 53 deletions(-)
diff --git a/.github/workflows/run-static.yml b/.github/workflows/run-static.yml
index 30451ba18..0b172865d 100644
--- a/.github/workflows/run-static.yml
+++ b/.github/workflows/run-static.yml
@@ -77,6 +77,7 @@ jobs:
# Check if docs.json content changed (ignoring formatting)
if ! jq --sort-keys . docs/docs.json.orig | diff -q - <(jq --sort-keys . docs/docs.json) > /dev/null 2>&1; then
echo "❌ docs.json content has changed!"
+ echo ""
echo "Run `just api-ref-all` to regenerate the SDK docs, then commit the changes. Note: you may need to install `just` (https://github.com/casey/just)"
exit 1
fi
diff --git a/docs/python-sdk/fastmcp-cli-run.mdx b/docs/python-sdk/fastmcp-cli-run.mdx
index 4aaf9995d..0e48d7e93 100644
--- a/docs/python-sdk/fastmcp-cli-run.mdx
+++ b/docs/python-sdk/fastmcp-cli-run.mdx
@@ -53,7 +53,7 @@ Import a MCP server from a file.
- The server object (or result of calling a factory function)
-### `run_with_uv`
+### `run_with_uv`
```python
run_with_uv(server_spec: str, python_version: str | None = None, with_packages: list[str] | None = None, with_requirements: Path | None = None, project: Path | None = None, transport: TransportType | None = None, host: str | None = None, port: int | None = None, path: str | None = None, log_level: LogLevelType | None = None, show_banner: bool = True) -> None
@@ -76,7 +76,7 @@ Run a MCP server using uv run subprocess.
- `show_banner`: Whether to show the server banner
-### `create_client_server`
+### `create_client_server`
```python
create_client_server(url: str) -> Any
@@ -92,7 +92,7 @@ Create a FastMCP server from a client URL.
- A FastMCP server instance
-### `create_mcp_config_server`
+### `create_mcp_config_server`
```python
create_mcp_config_server(mcp_config_path: Path) -> FastMCP[None]
@@ -102,7 +102,7 @@ create_mcp_config_server(mcp_config_path: Path) -> FastMCP[None]
Create a FastMCP server from a MCPConfig.
-### `import_server_with_args`
+### `import_server_with_args`
```python
import_server_with_args(file: Path, server_or_factory: str | None = None, server_args: list[str] | None = None) -> Any
@@ -120,7 +120,7 @@ Import a server with optional command line arguments.
- The imported server object
-### `run_command`
+### `run_command`
```python
run_command(server_spec: str, transport: TransportType | None = None, host: str | None = None, port: int | None = None, path: str | None = None, log_level: LogLevelType | None = None, server_args: list[str] | None = None, show_banner: bool = True, use_direct_import: bool = False) -> None
@@ -141,7 +141,7 @@ Run a MCP server or connect to a remote one.
- `use_direct_import`: Whether to use direct import instead of subprocess
-### `run_v1_server`
+### `run_v1_server`
```python
run_v1_server(server: FastMCP1x, host: str | None = None, port: int | None = None, transport: TransportType | None = None) -> None
diff --git a/docs/python-sdk/fastmcp-server-auth-auth.mdx b/docs/python-sdk/fastmcp-server-auth-auth.mdx
index fcc2a5667..b576b6515 100644
--- a/docs/python-sdk/fastmcp-server-auth-auth.mdx
+++ b/docs/python-sdk/fastmcp-server-auth-auth.mdx
@@ -107,7 +107,7 @@ the authorization servers that issue valid tokens.
**Methods:**
-#### `verify_token`
+#### `verify_token`
```python
verify_token(self, token: str) -> AccessToken | None
@@ -116,7 +116,7 @@ verify_token(self, token: str) -> AccessToken | None
Verify token using the configured token verifier.
-#### `get_routes`
+#### `get_routes`
```python
get_routes(self) -> list[Route]
@@ -129,7 +129,7 @@ Subclasses can override this method to add additional routes by calling
super().get_routes() and extending the returned list.
-### `OAuthProvider`
+### `OAuthProvider`
OAuth Authorization Server provider.
@@ -140,7 +140,7 @@ authorization flows, token issuance, and token verification.
**Methods:**
-#### `verify_token`
+#### `verify_token`
```python
verify_token(self, token: str) -> AccessToken | None
@@ -158,7 +158,7 @@ to our existing load_access_token method.
- AccessToken object if valid, None if invalid or expired
-#### `get_routes`
+#### `get_routes`
```python
get_routes(self) -> list[Route]
diff --git a/docs/python-sdk/fastmcp-server-context.mdx b/docs/python-sdk/fastmcp-server-context.mdx
index cc3c79237..fc6219fef 100644
--- a/docs/python-sdk/fastmcp-server-context.mdx
+++ b/docs/python-sdk/fastmcp-server-context.mdx
@@ -111,7 +111,7 @@ Read a resource by URI.
- The resource content as either text or bytes
-#### `log`
+#### `log`
```python
log(self, message: str, level: LoggingLevel | None = None, logger_name: str | None = None, extra: Mapping[str, Any] | None = None) -> None
@@ -127,7 +127,7 @@ Send a log message to the client.
- `extra`: Optional mapping for additional arguments
-#### `client_id`
+#### `client_id`
```python
client_id(self) -> str | None
@@ -136,7 +136,7 @@ client_id(self) -> str | None
Get the client ID if available.
-#### `request_id`
+#### `request_id`
```python
request_id(self) -> str
@@ -145,7 +145,7 @@ request_id(self) -> str
Get the unique ID for this request.
-#### `session_id`
+#### `session_id`
```python
session_id(self) -> str
@@ -162,7 +162,7 @@ the same client session.
- for other transports.
-#### `session`
+#### `session`
```python
session(self) -> ServerSession
@@ -171,7 +171,7 @@ session(self) -> ServerSession
Access to the underlying session for advanced usage.
-#### `debug`
+#### `debug`
```python
debug(self, message: str, logger_name: str | None = None, extra: Mapping[str, Any] | None = None) -> None
@@ -180,7 +180,7 @@ debug(self, message: str, logger_name: str | None = None, extra: Mapping[str, An
Send a debug log message.
-#### `info`
+#### `info`
```python
info(self, message: str, logger_name: str | None = None, extra: Mapping[str, Any] | None = None) -> None
@@ -189,7 +189,7 @@ info(self, message: str, logger_name: str | None = None, extra: Mapping[str, Any
Send an info log message.
-#### `warning`
+#### `warning`
```python
warning(self, message: str, logger_name: str | None = None, extra: Mapping[str, Any] | None = None) -> None
@@ -198,7 +198,7 @@ warning(self, message: str, logger_name: str | None = None, extra: Mapping[str,
Send a warning log message.
-#### `error`
+#### `error`
```python
error(self, message: str, logger_name: str | None = None, extra: Mapping[str, Any] | None = None) -> None
@@ -207,7 +207,7 @@ error(self, message: str, logger_name: str | None = None, extra: Mapping[str, An
Send an error log message.
-#### `list_roots`
+#### `list_roots`
```python
list_roots(self) -> list[Root]
@@ -216,7 +216,7 @@ list_roots(self) -> list[Root]
List the roots available to the server, as indicated by the client.
-#### `send_tool_list_changed`
+#### `send_tool_list_changed`
```python
send_tool_list_changed(self) -> None
@@ -225,7 +225,7 @@ send_tool_list_changed(self) -> None
Send a tool list changed notification to the client.
-#### `send_resource_list_changed`
+#### `send_resource_list_changed`
```python
send_resource_list_changed(self) -> None
@@ -234,7 +234,7 @@ send_resource_list_changed(self) -> None
Send a resource list changed notification to the client.
-#### `send_prompt_list_changed`
+#### `send_prompt_list_changed`
```python
send_prompt_list_changed(self) -> None
@@ -243,7 +243,7 @@ send_prompt_list_changed(self) -> None
Send a prompt list changed notification to the client.
-#### `sample`
+#### `sample`
```python
sample(self, messages: str | list[str | SamplingMessage], system_prompt: str | None = None, include_context: IncludeContext | None = None, temperature: float | None = None, max_tokens: int | None = None, model_preferences: ModelPreferences | str | list[str] | None = None) -> ContentBlock
@@ -256,25 +256,25 @@ completion from the client. The client must be appropriately configured,
or the request will error.
-#### `elicit`
+#### `elicit`
```python
elicit(self, message: str, response_type: None) -> AcceptedElicitation[dict[str, Any]] | DeclinedElicitation | CancelledElicitation
```
-#### `elicit`
+#### `elicit`
```python
elicit(self, message: str, response_type: type[T]) -> AcceptedElicitation[T] | DeclinedElicitation | CancelledElicitation
```
-#### `elicit`
+#### `elicit`
```python
elicit(self, message: str, response_type: list[str]) -> AcceptedElicitation[str] | DeclinedElicitation | CancelledElicitation
```
-#### `elicit`
+#### `elicit`
```python
elicit(self, message: str, response_type: type[T] | list[str] | None = None) -> AcceptedElicitation[T] | AcceptedElicitation[dict[str, Any]] | AcceptedElicitation[str] | DeclinedElicitation | CancelledElicitation
@@ -303,7 +303,7 @@ type or dataclass or BaseModel. If it is a primitive type, an
object schema with a single "value" field will be generated.
-#### `get_http_request`
+#### `get_http_request`
```python
get_http_request(self) -> Request
@@ -312,7 +312,7 @@ get_http_request(self) -> Request
Get the active starlette request.
-#### `set_state`
+#### `set_state`
```python
set_state(self, key: str, value: Any) -> None
@@ -321,7 +321,7 @@ set_state(self, key: str, value: Any) -> None
Set a value in the context state.
-#### `get_state`
+#### `get_state`
```python
get_state(self, key: str) -> Any
diff --git a/docs/python-sdk/fastmcp-utilities-components.mdx b/docs/python-sdk/fastmcp-utilities-components.mdx
index e18484bec..c7494f52f 100644
--- a/docs/python-sdk/fastmcp-utilities-components.mdx
+++ b/docs/python-sdk/fastmcp-utilities-components.mdx
@@ -55,7 +55,7 @@ Create a copy of the component.
- `key`: The key to use for the copy.
-#### `enable`
+#### `enable`
```python
enable(self) -> None
@@ -64,7 +64,7 @@ enable(self) -> None
Enable the component.
-#### `disable`
+#### `disable`
```python
disable(self) -> None
@@ -73,7 +73,7 @@ disable(self) -> None
Disable the component.
-#### `copy`
+#### `copy`
```python
copy(self) -> Self
@@ -82,7 +82,7 @@ copy(self) -> Self
Create a copy of the component.
-### `MirroredComponent`
+### `MirroredComponent`
Base class for components that are mirrored from a remote server.
@@ -93,7 +93,7 @@ to create a local version you can modify.
**Methods:**
-#### `enable`
+#### `enable`
```python
enable(self) -> None
@@ -102,7 +102,7 @@ enable(self) -> None
Enable the component.
-#### `disable`
+#### `disable`
```python
disable(self) -> None
@@ -111,7 +111,7 @@ disable(self) -> None
Disable the component.
-#### `copy`
+#### `copy`
```python
copy(self) -> Self
diff --git a/src/fastmcp/cli/run.py b/src/fastmcp/cli/run.py
index 9a0a47971..900110021 100644
--- a/src/fastmcp/cli/run.py
+++ b/src/fastmcp/cli/run.py
@@ -80,9 +80,6 @@ async def import_server(file: Path, server_or_factory: str | None = None) -> Any
logger.error("Could not load module", extra={"file": str(file)})
sys.exit(1)
- assert spec is not None
- assert spec.loader is not None
-
module = importlib.util.module_from_spec(spec)
spec.loader.exec_module(module)
@@ -102,8 +99,6 @@ async def import_server(file: Path, server_or_factory: str | None = None) -> Any
)
sys.exit(1)
- assert server_or_factory is not None
-
# Handle module:object syntax
if ":" in server_or_factory:
module_name, object_name = server_or_factory.split(":", 1)
diff --git a/src/fastmcp/experimental/server/openapi/routing.py b/src/fastmcp/experimental/server/openapi/routing.py
index ca7ebdb94..092b2445b 100644
--- a/src/fastmcp/experimental/server/openapi/routing.py
+++ b/src/fastmcp/experimental/server/openapi/routing.py
@@ -110,8 +110,6 @@ def _determine_route_type(
# Tags don't match, continue to next mapping
continue
- # We know mcp_type is not None here due to post_init validation
- assert route_map.mcp_type is not None
logger.debug(
f"Route {route.method} {route.path} mapped to {route_map.mcp_type.name}"
)
diff --git a/src/fastmcp/experimental/server/openapi/server.py b/src/fastmcp/experimental/server/openapi/server.py
index 101427375..9df9b046f 100644
--- a/src/fastmcp/experimental/server/openapi/server.py
+++ b/src/fastmcp/experimental/server/openapi/server.py
@@ -163,8 +163,6 @@ class FastMCPOpenAPI(FastMCP):
# Determine route type based on mappings or default rules
route_map = _determine_route_type(route, route_maps)
- # TODO: remove this once RouteType is removed and mcp_type is typed as MCPType without | None
- assert route_map.mcp_type is not None
route_type = route_map.mcp_type
# Call route_map_fn if provided
diff --git a/src/fastmcp/server/auth/auth.py b/src/fastmcp/server/auth/auth.py
index 2dd316793..3c2f3f59d 100644
--- a/src/fastmcp/server/auth/auth.py
+++ b/src/fastmcp/server/auth/auth.py
@@ -135,6 +135,8 @@ class RemoteAuthProvider(AuthProvider):
the authorization servers that issue valid tokens.
"""
+ resource_server_url: AnyHttpUrl
+
def __init__(
self,
token_verifier: TokenVerifier,
@@ -169,7 +171,6 @@ class RemoteAuthProvider(AuthProvider):
Subclasses can override this method to add additional routes by calling
super().get_routes() and extending the returned list.
"""
- assert self.resource_server_url is not None
return create_protected_resource_routes(
resource_url=self.resource_server_url,
diff --git a/src/fastmcp/server/context.py b/src/fastmcp/server/context.py
index 8a3901830..07a867d3e 100644
--- a/src/fastmcp/server/context.py
+++ b/src/fastmcp/server/context.py
@@ -188,7 +188,8 @@ class Context:
Returns:
The resource content as either text or bytes
"""
- assert self.fastmcp is not None, "Context is not available outside of a request"
+ if self.fastmcp is None:
+ raise ValueError("Context is not available outside of a request")
return await self.fastmcp._mcp_read_resource(uri)
async def log(
diff --git a/src/fastmcp/utilities/components.py b/src/fastmcp/utilities/components.py
index 8306b1e67..a0c4468ac 100644
--- a/src/fastmcp/utilities/components.py
+++ b/src/fastmcp/utilities/components.py
@@ -117,7 +117,8 @@ class FastMCPComponent(FastMCPBaseModel):
def __eq__(self, other: object) -> bool:
if type(self) is not type(other):
return False
- assert isinstance(other, type(self))
+ if not isinstance(other, type(self)):
+ return False
return self.model_dump() == other.model_dump()
def __repr__(self) -> str:
diff --git a/src/fastmcp/utilities/json_schema_type.py b/src/fastmcp/utilities/json_schema_type.py
index 62577402b..b6ba9266a 100644
--- a/src/fastmcp/utilities/json_schema_type.py
+++ b/src/fastmcp/utilities/json_schema_type.py
@@ -449,7 +449,8 @@ def _create_pydantic_model(
) -> type:
"""Create Pydantic BaseModel from object schema with additionalProperties."""
name = name or schema.get("title", "Root")
- assert name is not None # Should not be None after the or operation
+ if name is None:
+ raise ValueError("Name is required")
sanitized_name = _sanitize_name(name)
schema_hash = _hash_schema(schema)
cache_key = (schema_hash, sanitized_name)
@@ -507,7 +508,8 @@ def _create_dataclass(
"""Create dataclass from object schema."""
name = name or schema.get("title", "Root")
# Sanitize name for class creation
- assert name is not None # Should not be None after the or operation
+ if name is None:
+ raise ValueError("Name is required")
sanitized_name = _sanitize_name(name)
schema_hash = _hash_schema(schema)
cache_key = (schema_hash, sanitized_name)
From 7beeb949a082563a95a623d16232924e0bdc00da Mon Sep 17 00:00:00 2001
From: Jeremiah Lowin <153965+jlowin@users.noreply.github.com>
Date: Wed, 13 Aug 2025 21:55:30 -0400
Subject: [PATCH 2/2] Update deployment docs (#1486)
---
.../images/fastmcp_cloud/create_project.png | Bin 0 -> 636387 bytes
.../images/fastmcp_cloud/deployment.png | Bin 0 -> 692138 bytes
.../images/fastmcp_cloud/quickstart.png | Bin 0 -> 618836 bytes
docs/deployment/fastmcp-cloud.mdx | 54 +++
docs/deployment/running-server.mdx | 359 +++++++-----------
docs/deployment/self-hosted.mdx | 209 ++++++++++
docs/deployment/testing.mdx | 159 ++++++++
docs/docs.json | 42 +-
docs/patterns/testing.mdx | 48 ---
docs/servers/server.mdx | 25 ++
10 files changed, 611 insertions(+), 285 deletions(-)
create mode 100644 docs/assets/images/fastmcp_cloud/create_project.png
create mode 100644 docs/assets/images/fastmcp_cloud/deployment.png
create mode 100644 docs/assets/images/fastmcp_cloud/quickstart.png
create mode 100644 docs/deployment/fastmcp-cloud.mdx
create mode 100644 docs/deployment/self-hosted.mdx
create mode 100644 docs/deployment/testing.mdx
delete mode 100644 docs/patterns/testing.mdx
diff --git a/docs/assets/images/fastmcp_cloud/create_project.png b/docs/assets/images/fastmcp_cloud/create_project.png
new file mode 100644
index 0000000000000000000000000000000000000000..e34c8a1f4c713a75926cbc4219ef97a9187b89a9
GIT binary patch
literal 636387
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