Drop mcp package dependency, inline protocol types

CHANGELOG.md

@@ -7,6 +7,7 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 ## Fixed
 - [#3822](https://github.com/plotly/dash/pull/3822) Fix `UnboundLocalError` for `user_callback_output` in async background callbacks (Celery and Diskcache managers) when the callback raises `PreventUpdate` or another exception before the variable is assigned.
 - [#3819](https://github.com/plotly/dash/pull/3819) Fix `RuntimeError: No active request in context` when a non-Dash path falls through to the FastAPI catch-all route. Fixes [#3812](https://github.com/plotly/dash/issues/3812).
+- [#3838](https://github.com/plotly/dash/pull/3838) Replace `mcp` dependency with inline types
 
 ## [4.3.0] - 2026-06-18
 

dash/mcp/_server.py

@@ -13,7 +13,7 @@
 import os
 from typing import TYPE_CHECKING, Any
 
-from mcp.types import (
+from dash.mcp.types import (
     LATEST_PROTOCOL_VERSION,
     ErrorData,
     Implementation,

dash/mcp/primitives/resources/__init__.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from mcp.types import (
+from dash.mcp.types import (
     ListResourcesResult,
     ListResourceTemplatesResult,
     ReadResourceResult,

dash/mcp/primitives/resources/base.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from mcp.types import ReadResourceResult, Resource, ResourceTemplate
+from dash.mcp.types import ReadResourceResult, Resource, ResourceTemplate
 
 
 class MCPResourceProvider:

dash/mcp/primitives/resources/resource_clientside_callbacks.py

@@ -5,12 +5,13 @@
 import json
 from typing import Any
 
-from mcp.types import (
+from pydantic import AnyUrl
+
+from dash.mcp.types import (
     ReadResourceResult,
     Resource,
     TextResourceContents,
 )
-from pydantic import AnyUrl
 
 from dash import get_app
 from dash._utils import clean_property_name, split_callback_id

dash/mcp/primitives/resources/resource_components.py

@@ -4,12 +4,13 @@
 
 import json
 
-from mcp.types import (
+from pydantic import AnyUrl
+
+from dash.mcp.types import (
     ReadResourceResult,
     Resource,
     TextResourceContents,
 )
-from pydantic import AnyUrl
 
 from dash import get_app
 from dash._layout_utils import traverse

dash/mcp/primitives/resources/resource_layout.py

@@ -2,12 +2,13 @@
 
 from __future__ import annotations
 
-from mcp.types import (
+from pydantic import AnyUrl
+
+from dash.mcp.types import (
     ReadResourceResult,
     Resource,
     TextResourceContents,
 )
-from pydantic import AnyUrl
 
 from dash import get_app
 from dash._utils import to_json

dash/mcp/primitives/resources/resource_page_layout.py

@@ -2,12 +2,13 @@
 
 from __future__ import annotations
 
-from mcp.types import (
+from pydantic import AnyUrl
+
+from dash.mcp.types import (
     ReadResourceResult,
     ResourceTemplate,
     TextResourceContents,
 )
-from pydantic import AnyUrl
 
 from dash import html
 from dash._pages import PAGE_REGISTRY

dash/mcp/primitives/resources/resource_pages.py

@@ -4,12 +4,13 @@
 
 import json
 
-from mcp.types import (
+from pydantic import AnyUrl
+
+from dash.mcp.types import (
     ReadResourceResult,
     Resource,
     TextResourceContents,
 )
-from pydantic import AnyUrl
 
 from dash._pages import PAGE_REGISTRY
 

dash/mcp/primitives/tools/__init__.py

@@ -4,7 +4,7 @@
 
 from typing import Any
 
-from mcp.types import CallToolResult, CreateTaskResult, ListToolsResult
+from dash.mcp.types import CallToolResult, CreateTaskResult, ListToolsResult
 
 from dash.mcp.types import ToolNotFoundError
 

dash/mcp/primitives/tools/base.py

@@ -4,7 +4,7 @@
 
 from typing import Any
 
-from mcp.types import CallToolResult, CreateTaskResult, Tool
+from dash.mcp.types import CallToolResult, CreateTaskResult, Tool
 
 
 class MCPToolProvider:

dash/mcp/primitives/tools/callback_adapter.py

@@ -12,7 +12,7 @@
 from functools import cached_property
 from typing import Any, cast
 
-from mcp.types import Tool
+from dash.mcp.types import Tool
 
 from dash import get_app
 from dash._layout_utils import (

dash/mcp/primitives/tools/callback_adapter_collection.py

@@ -10,7 +10,7 @@
 from functools import cached_property
 from typing import Any
 
-from mcp.types import Tool
+from dash.mcp.types import Tool
 
 from dash import get_app
 from dash._utils import clean_property_name, split_callback_id

dash/mcp/primitives/tools/results/__init__.py

@@ -9,7 +9,7 @@
 import json
 from typing import TYPE_CHECKING, Any
 
-from mcp.types import CallToolResult, CreateTaskResult, TextContent
+from dash.mcp.types import CallToolResult, CreateTaskResult, TextContent
 
 from dash.types import CallbackExecutionResponse
 

dash/mcp/primitives/tools/results/base.py

@@ -4,7 +4,7 @@
 
 from typing import Any
 
-from mcp.types import ImageContent, TextContent
+from dash.mcp.types import ImageContent, TextContent
 
 from dash.mcp.types import MCPOutput
 

dash/mcp/primitives/tools/results/result_dataframe.py

@@ -9,7 +9,7 @@
 
 from typing import Any
 
-from mcp.types import TextContent
+from dash.mcp.types import TextContent
 
 from dash.mcp.types import MCPOutput
 

dash/mcp/primitives/tools/results/result_plotly_figure.py

@@ -7,7 +7,7 @@
 from typing import Any
 
 import plotly.graph_objects as go  # type: ignore[import-untyped]
-from mcp.types import ImageContent, TextContent
+from dash.mcp.types import ImageContent, TextContent
 
 from dash.mcp.types import MCPOutput
 

dash/mcp/primitives/tools/tool_background_tasks.py

@@ -8,7 +8,7 @@
 
 from typing import Any
 
-from mcp.types import CallToolResult, TextContent, Tool
+from dash.mcp.types import CallToolResult, TextContent, Tool
 
 from dash import get_app
 from dash.mcp.tasks import get_task, get_task_result, cancel_task

dash/mcp/primitives/tools/tool_decorated_mcp_functions.py

@@ -7,7 +7,7 @@
 import typing
 from typing import Any, Callable
 
-from mcp.types import CallToolResult, TextContent, Tool
+from dash.mcp.types import CallToolResult, TextContent, Tool
 
 from dash import get_app
 from dash.mcp._decorator import MCPToolRegistration

dash/mcp/primitives/tools/tool_get_dash_component.py

@@ -5,13 +5,18 @@
 import json
 from typing import Any
 
-from mcp.types import CallToolResult, TextContent, Tool
 from pydantic import Field, TypeAdapter
 from typing_extensions import Annotated, NotRequired, TypedDict
 
 from dash import get_app
 from dash._layout_utils import find_component
-from dash.mcp.types import ComponentPropertyInfo, ComponentQueryResult
+from dash.mcp.types import (
+    CallToolResult,
+    ComponentPropertyInfo,
+    ComponentQueryResult,
+    TextContent,
+    Tool,
+)
 
 from .base import MCPToolProvider
 

dash/mcp/primitives/tools/tools_callbacks.py

@@ -7,7 +7,7 @@
 
 from typing import Any
 
-from mcp.types import CallToolResult, CreateTaskResult, TextContent, Tool
+from dash.mcp.types import CallToolResult, CreateTaskResult, TextContent, Tool
 
 from dash import get_app
 from dash.mcp.tasks import create_task

dash/mcp/tasks/tasks.py

@@ -5,7 +5,7 @@
 from datetime import datetime, timezone
 from typing import Any, Literal
 
-from mcp.types import CancelTaskResult, CreateTaskResult, GetTaskResult, Task
+from dash.mcp.types import CancelTaskResult, CreateTaskResult, GetTaskResult, Task
 
 from dash import get_app
 from dash._callback import _update_background_callback, _prepare_response

dash/mcp/types/__init__.py

@@ -11,16 +11,66 @@
     MCPError,
     ToolNotFoundError,
 )
+from dash.mcp.types.protocol import (
+    LATEST_PROTOCOL_VERSION,
+    CallToolResult,
+    CancelTaskResult,
+    CreateTaskResult,
+    ErrorData,
+    GetTaskResult,
+    ImageContent,
+    Implementation,
+    InitializeResult,
+    JSONRPCError,
+    JSONRPCResponse,
+    ListResourcesResult,
+    ListResourceTemplatesResult,
+    ListToolsResult,
+    ReadResourceResult,
+    Resource,
+    ResourcesCapability,
+    ResourceTemplate,
+    ServerCapabilities,
+    Task,
+    TextContent,
+    TextResourceContents,
+    Tool,
+    ToolsCapability,
+)
 from dash.mcp.types.typing_utils import is_nullable
 
 __all__ = [
+    "LATEST_PROTOCOL_VERSION",
     "CallbackExecutionError",
+    "CallToolResult",
+    "CancelTaskResult",
     "ComponentPropertyInfo",
     "ComponentQueryResult",
+    "CreateTaskResult",
+    "ErrorData",
+    "GetTaskResult",
+    "ImageContent",
+    "Implementation",
+    "InitializeResult",
     "InvalidParamsError",
+    "JSONRPCError",
+    "JSONRPCResponse",
+    "ListResourcesResult",
+    "ListResourceTemplatesResult",
+    "ListToolsResult",
     "MCPError",
     "MCPInput",
     "MCPOutput",
+    "ReadResourceResult",
+    "Resource",
+    "ResourcesCapability",
+    "ResourceTemplate",
+    "ServerCapabilities",
+    "Task",
+    "TextContent",
+    "TextResourceContents",
+    "Tool",
     "ToolNotFoundError",
+    "ToolsCapability",
     "is_nullable",
 ]