VictoriaTraces

VictoriaTraces

MCP server for VictoriaTraces enabling read-only API access, offline docs, and tooling.

4
Stars
0
Forks
4
Releases

Overview

VictoriaTraces MCP Server implements the Model Context Protocol (MCP) to expose your VictoriaTraces instance through MCP-compatible interactions. It provides access to VictoriaTraces data and seamless integration with VictoriaTraces APIs and documentation, delivering a comprehensive interface for traces, observability, and debugging tasks related to your VictoriaTraces deployments. The server exposes read-only APIs such as retrieving services and operations (span names) and querying traces to explore and analyze trace data. It also ships with embedded, up-to-date VictoriaTraces documentation and a built-in search capability so you can access information even offline. The project includes a toolbox of built-in tools (documentation, services, service_names, traces, trace, dependencies) and pre-defined prompts to assist common tasks. It supports multiple transports (stdio, SSE, HTTP) and exposes endpoints for streaming, messaging, metrics, and health checks. The MCP server can be used standalone or combined with other MCP servers to extend observability workflows. Configuration is via environment variables (VT_INSTANCE_ENTRYPOINT, VT_INSTANCE_BEARER_TOKEN, VT_INSTANCE_HEADERS) and is subject to client and model capabilities.

Details

Owner
VictoriaMetrics-Community
Language
Go
License
Apache License 2.0
Updated
2025-12-07

Features

Read-only VictoriaTraces API access

Expose read-only VictoriaTraces APIs, including retrieving services and operations (span names) and querying traces to explore and analyze trace data.

Embedded offline documentation search

Contains embedded, up-to-date VictoriaTraces documentation with a built-in search capability for offline access.

Built-in MCP toolset

Includes tools for interaction: documentation, services, service_names, traces, trace, and dependencies.

Pre-defined prompts library

Offers pre-defined prompts to assist with common tasks and workflows.

Multiple transport modes

Supports stdio, SSE, and HTTP transports, with corresponding endpoints for streaming and messaging.

Endpoints and health checks

Exposes MCP endpoints such as /sse, /message, /mcp, /metrics and health checks (/health/liveness, /health/readiness).

Composable with other MCP servers

Designed to be used standalone or combined with other MCP servers to extend observability workflows.

Audience

EngineersAutomate traces analysis and debugging tasks using VictoriaTraces via MCP.
DevelopersIntegrate VictoriaTraces data into apps and assistants via MCP tooling.
Automation toolsOrchestrate trace queries and docs search across VictoriaTraces with MCP-enabled tooling.

Tags

VictoriaTracesMCPModel Context Protocoltracesdocumentationofflineobservabilitydebuggingservicesprompts