feat(integrations): initial implementation of MCP integration

Author: constantinius

sentry_sdk/consts.py

@@ -749,6 +749,36 @@ class SPANDATA:
     Example: "MainThread"
     """
 
+    MCP_TOOL_NAME = "mcp.tool.name"
+    """
+    The name of the MCP tool being called.
+    Example: "get_weather"
+    """
+
+    MCP_PROMPT_NAME = "mcp.prompt.name"
+    """
+    The name of the MCP prompt being retrieved.
+    Example: "code_review"
+    """
+
+    MCP_RESOURCE_URI = "mcp.resource.uri"
+    """
+    The URI of the MCP resource being accessed.
+    Example: "file:///path/to/resource"
+    """
+
+    MCP_METHOD_NAME = "mcp.method.name"
+    """
+    The MCP protocol method name being called.
+    Example: "tools/call", "prompts/get", "resources/read"
+    """
+
+    MCP_REQUEST_ID = "mcp.request.id"
+    """
+    The unique identifier for the MCP request.
+    Example: "req_123abc"
+    """
+
 
 class SPANSTATUS:
     """
@@ -845,6 +875,9 @@ class OP:
     WEBSOCKET_SERVER = "websocket.server"
     SOCKET_CONNECTION = "socket.connection"
     SOCKET_DNS = "socket.dns"
+    MCP_TOOL = "mcp.tool"
+    MCP_PROMPT = "mcp.prompt"
+    MCP_RESOURCE = "mcp.resource"
 
 
 # This type exists to trick mypy and PyCharm into thinking `init` and `Client`

sentry_sdk/integrations/__init__.py

@@ -98,6 +98,7 @@ def iter_default_integrations(with_auto_enabling_integrations):
     "sentry_sdk.integrations.langgraph.LanggraphIntegration",
     "sentry_sdk.integrations.litestar.LitestarIntegration",
     "sentry_sdk.integrations.loguru.LoguruIntegration",
+    "sentry_sdk.integrations.mcp.MCPIntegration",
     "sentry_sdk.integrations.openai.OpenAIIntegration",
     "sentry_sdk.integrations.pymongo.PyMongoIntegration",
     "sentry_sdk.integrations.pyramid.PyramidIntegration",

sentry_sdk/integrations/mcp/__init__.py

@@ -0,0 +1,37 @@
+"""
+Sentry integration for MCP (Model Context Protocol) servers.
+
+This integration instruments MCP servers to create spans for tool, prompt,
+and resource handler execution, and captures errors that occur during execution.
+
+Supports both the low-level `mcp.server.lowlevel.Server` and high-level
+`mcp.server.fastmcp.FastMCP` APIs.
+"""
+
+from sentry_sdk.integrations import Integration, DidNotEnable
+
+try:
+    import mcp.server.lowlevel  # noqa: F401
+    import mcp.server.fastmcp  # noqa: F401
+except ImportError:
+    raise DidNotEnable("MCP SDK not installed")
+
+
+class MCPIntegration(Integration):
+    identifier = "mcp"
+    origin = "auto.ai.mcp"
+
+    @staticmethod
+    def setup_once():
+        # type: () -> None
+        """
+        Patches MCP server classes to instrument handler execution.
+        """
+        from sentry_sdk.integrations.mcp.lowlevel import patch_lowlevel_server
+        from sentry_sdk.integrations.mcp.fastmcp import patch_fastmcp_server
+
+        patch_lowlevel_server()
+        patch_fastmcp_server()
+
+
+__all__ = ["MCPIntegration"]