observatory-mcp

# Observatory MCP Python SDK [](https://badge.fury.io/py/observatory-mcp) [](https://www.python.org/downloads/) [](https://opensource.org/licenses/MIT) **Add comprehensive analytics and monitoring to your MCP servers with just 2-3 lines of code.** Observatory SDK provides lightweight, zero-configuration observability for Model Context Protocol (MCP) servers. Track performance metrics, protocol messages, errors, and user behavior without modifying your existing MCP server implementation. ## ✨ Features - 🚀 **2-Line Integration**: Add observability with minimal code changes - 📊 **Complete Analytics**: Protocol messages, performance metrics, error tracking - 🔒 **Privacy-First**: Built-in PII detection and data masking - ⚡ **Lightweight**: <1ms overhead per message, async processing - 🎯 **Smart Sampling**: Adaptive sampling with error prioritization - 🔌 **Zero Server Modification**: Works via protocol message interception - 📈 **Real-Time Monitoring**: Live dashboards and alerting - 🐍 **Type-Safe**: Full type hints for IDE autocomplete ## 📦 Installation ```bash pip install observatory-mcp ``` For MCP server integration: ```bash pip install observatory-mcp[mcp] ``` For development: ```bash pip install observatory-mcp[dev] ``` ## 🚀 Quick Start ### Basic Integration (2 lines!) ```python from mcp.server import Server from observatory_mcp import ObservatorySDK # Create your MCP server as usual app = Server("my-awesome-mcp-server") # Add Observatory with 2 lines! observatory = ObservatorySDK( api_key="obs_live_xyz123", server_name="my-awesome-mcp-server", server_version="1.0.0" ) app = observatory.wrap_server(app) # Your handlers work exactly the same - Observatory tracks automatically! @app.list_tools() async def list_tools(): return [...] @ap…