mcp-observability

# MCP Observability SDK for Python Open, vendor-agnostic observability SDK for Model Context Protocol (MCP) applications. No vendor lock-in, plug-and-play integration, and extensible for rate limiting, tool filtering, auth, and traceability. ## Installation ```bash pip install mcp-hack ``` ## Quick Start ### 1. Get an API Key 1. Visit [https://etalesystems.com](https://etalesystems.com) 2. Sign in with your Google account 3. Create a new API key from the dashboard 4. Set your API key as an environment variable: ```bash export MCP_API_KEY="your_api_key_here" ``` ### 2. Use in Your Code ```python import os from mcp_observability import MCPObservability # Initialize observability obs = MCPObservability( api_url="https://etalesystems.com/api", # Production backend URL api_key=os.getenv('MCP_API_KEY') # Your API key from etalesystems.com ) # Add observability to your MCP tools @mcp.tool() @obs.tool_observer("add_numbers") def add(a: int, b: int) -> int: """Add two numbers""" return a + b # Get metrics metrics = obs.get_metrics() print(f"Total calls: {metrics['summary']['total_calls']}") ``` ## Features - 🔍 **Automatic Tool Tracing**: Monitor all MCP tool calls with zero configuration - 📊 **Rich Metrics**: Execution time, success rates, error tracking - 🚀 **Non-blocking**: Async trace submission doesn't slow down your tools - 🔒 **Secure**: API key authentication with environment variable support - 📈 **Dashboard Integration**: Real-time visualization of your MCP tools ## API Reference ### MCPObservability Main class for MCP observability. #### Constructor ```python MCPObservability(api_url: str, api_key: Optional[str] = None) ``` - `api_url`: URL of your observability backend - `api_key`: API key for authentication (optional, but required for trace submission) #### Methods ##### tool_observer(tool_name: Optional[str] = None) Decorator to add observability to MCP tools. ```python @obs.tool_observer("my_tool") def my_tool(param…