heimdall-mcp

Heimdall MCP is a transparent proxy designed for any MCP (Model Context Protocol) server, providing the ability to intercept all JSON-RPC messages, measure latency, and store traces in a versatile database, without modifying the original server.

This tool is particularly valuable for developers aiming to enhance their data tracing capabilities while maintaining the integrity of their existing setups. By utilizing OpenTelemetry tracing, Heimdall MCP allows for the monitoring and analysis of communication between MCP clients and servers.

Key Features

• Interception of JSON-RPC Messages: Seamlessly captures all messages with precise timing metrics.
• Tracing Storage: Configurable backend options include SQLite, PostgreSQL, and MySQL to suit various project needs.
• Multiple Usage Modes:
  • CLI mode for local subprocesses: Acts as a wrapper for locally run servers.
  • Remote HTTP Server Wrapping: Proxy for already deployed server instances.
  • SSE Server Support: Interact with servers utilizing Server-Sent Events.
  • Library for Integration: Easily incorporate into applications for customized setups.
• Custom Interceptor Support: Users can introduce their custom logic into the telemetry process.

How It Works

The architecture of Heimdall MCP ensures that the MCP client interacts with a proxy interface while the real MCP server communicates through standard I/O channels. Each request-response interaction is recorded as a span, capturing key attributes along with their respective input and output messages.

Jaeger Integration

The proxy can export each trace to a Jaeger instance for real-time visual monitoring via OTLP HTTP. This feature enhances the ability to track and optimize the performance of MCP communications, providing insights directly from the Jaeger UI.

Ideal Use Cases

• Developers looking to integrate performance monitoring into their existing workflows.
• Teams needing detailed insights and analytics on their MCP server interactions.
• Projects requiring an efficient and flexible tracing solution without altering server configurations.

For further details, implementation examples, and documentation, visit the Heimdall MCP Website.

With its rich feature set and flexibility, Heimdall MCP stands as a robust solution for anyone working with MCP servers who need reliable and detailed telemetry.