MCP Analytics Middleware
@Phillip-Kemper
A lightweight TypeScript middleware for MCP SDK servers that delivers analytics. Captures request metrics, performance data, and usage patterns with minimal overhead. Features real-time monitoring, configurable data collection, and detailed reporting - all with full type safety.
Overview
What is MCP Analytics Middleware?
MCP Analytics Middleware is a simple way to track and visualize how your MCP server is being used. It records tool calls and resource requests, tracks performance metrics and error rates, and provides a web dashboard for live analytics. It is for developers who want to understand which tools are most popular, catch errors early, and monitor server performance.
How to use MCP Analytics Middleware?
Install via yarn add mcp-analytics-middleware, then import McpAnalytics and wrap your McpServer instance with analytics.enhance(server). You can launch the live web dashboard with npx -p mcp-analytics-middleware web-viewer --db-path analytics.db, or use the MCP Inspector flag --analytics --db-path analytics.db.
Key features of MCP Analytics Middleware
- Track all tool calls and resource requests
- See performance metrics and error rates
- Web dashboard for live analytics
- SQLite database for persistent storage
Use cases of MCP Analytics Middleware
- Understand which tools are most popular in your MCP server
- Catch errors early by monitoring error rates
- Analyze your server's performance and slowest operations
FAQ from MCP Analytics Middleware
What does the middleware actually do?
It overrides tool and resource function implementations to record usage in an SQLite database.
How can I see the analytics live?
Run npx -p mcp-analytics-middleware web-viewer --db-path analytics.db and open http://localhost:8080.
What data does the dashboard show?
Total tool calls and resource requests, error rates, performance metrics, most used tools, and slowest operations.
