Grafana MCP Server

Instructions

Implementation Reference

• src/tools/pyroscope.ts:98-126 (handler)

  Full ToolDefinition for 'list_pyroscope_label_values' including the inline handler function that queries the Pyroscope API (/pyroscope/api/v1/label-values) for label values using axios.

  export const listPyroscopeLabelValues: ToolDefinition = {
    name: 'list_pyroscope_label_values',
    description: 'Lists all available label values for a particular label name in profiles',
    inputSchema: ListPyroscopeLabelValuesSchema,
    handler: async (params, context: ToolContext) => {
      try {
        const client = createPyroscopeClient(context.config.grafanaConfig, params.data_source_uid);
        const timeRange = params.start_rfc_3339 || params.end_rfc_3339 
          ? { start: '', end: '' } 
          : getDefaultTimeRange();
        
        const queryParams: any = {
          label: params.name,
          start: params.start_rfc_3339 || timeRange.start,
          end: params.end_rfc_3339 || timeRange.end,
        };
        
        if (params.matchers) {
          queryParams.matchers = params.matchers;
        }
        
        const response = await client.get('/pyroscope/api/v1/label-values', { params: queryParams });
        
        return createToolResult(response.data.data || []);
      } catch (error: any) {
        return createErrorResult(error.response?.data?.message || error.message);
      }
    },
  };

• src/tools/pyroscope.ts:13-19 (schema)

  Zod schema defining the input parameters for the list_pyroscope_label_values tool.

  const ListPyroscopeLabelValuesSchema = z.object({
    data_source_uid: z.string().describe('The UID of the datasource to query'),
    name: z.string().describe('A label name'),
    start_rfc_3339: z.string().optional().describe('Start time in RFC3339 format'),
    end_rfc_3339: z.string().optional().describe('End time in RFC3339 format'),
    matchers: z.string().optional().describe('Prometheus-style matchers'),
  });

• src/tools/pyroscope.ts:198-203 (registration)

  Registration function that registers all Pyroscope tools with the MCP server, including listPyroscopeLabelValues.

  export function registerPyroscopeTools(server: any) {
    server.registerTool(listPyroscopeLabelNames);
    server.registerTool(listPyroscopeLabelValues);
    server.registerTool(listPyroscopeProfileTypes);
    server.registerTool(fetchPyroscopeProfile);
  }

• src/tools/pyroscope.ts:37-53 (helper)

  Helper function to create an authenticated axios client for querying a Pyroscope datasource via Grafana proxy.

  function createPyroscopeClient(config: any, datasourceUid: string) {
    const headers: any = {
      'User-Agent': 'mcp-grafana/1.0.0',
    };
    
    if (config.serviceAccountToken) {
      headers['Authorization'] = `Bearer ${config.serviceAccountToken}`;
    } else if (config.apiKey) {
      headers['Authorization'] = `Bearer ${config.apiKey}`;
    }
    
    return axios.create({
      baseURL: `${config.url}/api/datasources/proxy/uid/${datasourceUid}`,
      headers,
      timeout: 30000,
    });
  }

• src/tools/pyroscope.ts:56-63 (helper)

  Helper function providing default time range (last hour) for queries when not specified.

  function getDefaultTimeRange(): { start: string; end: string } {
    const now = new Date();
    const oneHourAgo = new Date(now.getTime() - 60 * 60 * 1000);
    return {
      start: oneHourAgo.toISOString(),
      end: now.toISOString(),
    };
  }