A Go implementation of a Model Context Protocol (MCP) server that provides seamless integration with SigNoz, an open-source observability platform. This server enables AI assistants and other MCP clients to interact with SigNoz APIs for querying dashboards, metrics, traces, logs, and more.
Features
Signoz MCP Server - Golang
Estrellas
7
Herramientas
—
Disponibilidad
—
The Signoz MCP Server provides the following tools:
signoz_test_connection: Verify connectivity to your Signoz instance and configuration
signoz_fetch_dashboards: List all available dashboards from Signoz
signoz_fetch_dashboard_details: Retrieve detailed information about a specific dashboard by its ID
signoz_fetch_dashboard_data: Fetch all panel data for a given dashboard by name and time range
signoz_fetch_apm_metrics: Retrieve standard APM metrics (request rate, error rate, latency, apdex) for a given service and time range
signoz_fetch_services: Fetch all instrumented services from Signoz with optional time range filtering
signoz_execute_clickhouse_query: Execute custom ClickHouse SQL queries via the Signoz API with time range support
signoz_execute_builder_query: Execute Signoz builder queries for custom metrics and aggregations with time range support
signoz_fetch_traces_or_logs: Fetch traces or logs from SigNoz using ClickHouse SQL
Architecture
This project follows Clean Architecture principles with the following structure:
git clone https://github.com/CalmoAI/mcp-server-signoz.git
cd signoz-mcp-server
Install and update dependencies:
go mod tidy
Build the server:
go build -o signoz-mcp-server ./cmd/server
(Optional) Get the absolute path for configuration:
pwd
# This will show the full path to your binary: /path/to/signoz-mcp-server
Verify the installation:
# Test that the binary runs (it will start the MCP server)
./signoz-mcp-server
# Press Ctrl+C to stop the server
Option 2: Install with Go
go install github.com/CalmoAI/mcp-server-signoz/cmd/server@latest
Configuration
The server can be configured using environment variables, configuration files, or command-line flags.
Environment Variables
ANY configuration value can be overridden using environment variables with the SIGNOZ_MCP_ prefix. This provides complete flexibility for deployment and runtime configuration.
Replace /absolute/path/to/signoz-mcp-server with the full path to your built binary
The SIGNOZ_MCP_SIGNOZ_API_KEY is optional if your SigNoz instance doesn't require authentication
Ensure the binary has execute permissions (chmod +x signoz-mcp-server on Unix systems)
Using the Integration:
Restart Cursor IDE after updating the configuration
The SigNoz tools will be automatically available in Cursor's AI assistant
You can directly ask Cursor to use SigNoz commands like:
"Test my SigNoz connection"
"Show me all dashboards from SigNoz"
"Get APM metrics for my-service"
"Execute this ClickHouse query on SigNoz"
Integration with Other MCP Clients
The server implements the standard MCP protocol and can be used with any compatible MCP client. Refer to your client's documentation for specific integration instructions.
Tool Usage Examples
Test Connection
Use the signoz_test_connection tool to verify your Signoz instance is accessible.
Fetch Dashboards
Use signoz_fetch_dashboards to get a list of all available dashboards.
Fetch Dashboard Details
Use signoz_fetch_dashboard_details with dashboard_id: "your-dashboard-id" to get detailed information about a specific dashboard.
Fetch Dashboard Data
Use signoz_fetch_dashboard_data with:
- dashboard_name: "My Dashboard"
- start_time: "2023-12-01T00:00:00Z"
- end_time: "2023-12-01T01:00:00Z"
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Preguntas
¿Cómo instalo MCP Server Signoz?
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
¿MCP Server Signoz necesita una clave de API?
Este registro no indica ninguna variable de entorno obligatoria.
¿Qué transporte usa MCP Server Signoz?
MCP Server Signoz se ejecuta localmente por stdio.
¿Cuándo se comprobó MCP Server Signoz por última vez?
Última comprobación: 2026-10-28. Signoz MCP Server - Golang