Loading...
The VictoriaMetrics MCP server provides a Model Context Protocol interface for querying and interacting with VictoriaMetrics instances, enabling monitoring, observability, and debugging.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
The VictoriaMetrics MCP server provides a Model Context Protocol interface for querying and interacting with VictoriaMetrics instances, enabling monitoring, observability, and debugging.
The VictoriaMetrics MCP server is relatively safe for read-only operations and data exploration. However, caution should be exercised when using tools that modify alerting rules or other configurations. Ensure proper authentication and authorization are in place to mitigate risks.
Performance depends on the complexity of the queries and the size of the VictoriaMetrics dataset. Optimize queries for better performance.
Cost depends on the usage of VictoriaMetrics resources and any associated cloud service costs.
npx -y{
"mcpServers": {
"victoriametrics": {
"command": "/path/to/mcp-victoriametrics",
"env": {
"VM_INSTANCE_ENTRYPOINT": "<YOUR_VM_INSTANCE>",
"VM_INSTANCE_TYPE": "<YOUR_VM_INSTANCE_TYPE>",
"VM_INSTANCE_BEARER_TOKEN": "<YOUR_VM_BEARER_TOKEN>",
"VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}MCP_SERVER_MODEVM_INSTANCE_ENTRYPOINTVM_INSTANCE_TYPEVM_INSTANCE_BEARER_TOKENMCP_DISABLED_TOOLSVMC_API_KEYMCP_LISTEN_ADDRquerying metricsRetrieves metrics data from VictoriaMetrics based on a given query.
Read-only operation; no data modification.
listing metricsLists available metrics stored in VictoriaMetrics.
Read-only operation; no data modification.
analyzing alerting rulesAnalyzes and tests alerting rules defined in VictoriaMetrics.
Can modify alerting rule configurations.
exportExports data from VictoriaMetrics.
Read-only operation; exports data.
flagsShows parameters of your VictoriaMetrics instance
Read-only operation; shows parameters.
metric_relabel_debugDebugging your relabeling rules
Read-only operation; debugging relabeling rules.
downsampling_filters_debugDebugging your downsampling filters
Read-only operation; debugging downsampling filters.
retention_filters_debugDebugging your retention policy configurations
Read-only operation; debugging retention policy configurations.
test_rulesTesting your alerting and recording rules
Can modify alerting and recording rules.
API Key|Token|Environment Variable
hybrid
The VictoriaMetrics MCP server is relatively safe for read-only operations and data exploration. However, caution should be exercised when using tools that modify alerting rules or other configurations. Ensure proper authentication and authorization are in place to mitigate risks.
Autonomy depends on the configured tools and permissions. Read-only operations are generally safe, while write operations require careful consideration.
Production Tip
Monitor the MCP server's resource usage and ensure it has sufficient resources to handle the expected load.
It provides a Model Context Protocol interface for querying and interacting with VictoriaMetrics instances.
You can execute any read-only query supported by VictoriaMetrics, as well as use tools for analyzing alerting rules and exploring data.
You can authenticate using an API key, bearer token, or environment variables.
Yes, you can disable tools using the `MCP_DISABLED_TOOLS` environment variable.
The server supports `stdio`, `sse`, and `http` modes. See the documentation for details.
You can configure the endpoint using the `VM_INSTANCE_ENTRYPOINT` environment variable.
It is generally not recommended to expose the server directly to the internet without proper security measures, such as authentication and authorization.