📌Overview

Purpose: The Metoro MCP Server enables users to interact seamlessly with Kubernetes clusters through the Claude Desktop App, leveraging the Model Context Protocol (MCP) for integration.

Overview: The Metoro MCP Server acts as a bridge between large language models (LLMs) and Kubernetes infrastructure managed by the Metoro observability platform. It allows real-time queries and fetches telemetry data, enhancing AI applications with contextual information from microservices.

Key Features:

Integration with Claude Desktop App: Provides a user-friendly way to query Kubernetes data and interact with LLMs, streamlining the workflow for developers and data scientists.
Open Protocol Support: Built on the Model Context Protocol, facilitating easy connections between LLM applications and external data sources, making it adaptable for various AI-driven applications.
eBPF based Instrumentation: Employs eBPF for generating deep telemetry without requiring code changes, ensuring comprehensive observability of microservices and efficient performance metrics.

metoro-mcp-server

This repository contains the Metoro MCP (Model Context Protocol) Server. This MCP Server allows you to interact with your Kubernetes cluster via the Claude Desktop App!

What is MCP (Model Context Protocol)?

You can read more about the Model Context Protocol here: https://modelcontextprotocol.io

In brief:

The Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. Whether you’re building an AI-powered IDE, enhancing a chat interface, or creating custom AI workflows, MCP provides a standardized way to connect LLMs with the context they need.

What is Metoro?

Metoro (https://metoro.io/) is an observability platform designed for microservices running in Kubernetes. It uses eBPF-based instrumentation to generate deep telemetry without code changes. The data generated by the eBPF agents is sent to Metoro's backend to be stored and visualized in the Metoro frontend using APIs.

This MCP server exposes those APIs to an LLM so you can ask your AI questions about your Kubernetes cluster.

Demo

https://github.com/user-attachments/assets/b3f21e9a-45b8-4c17-8d8c-cff560d8694f

How to Use Metoro MCP Server

Install the Claude Desktop App: https://claude.ai/download
Ensure you have Golang installed: https://golang.org/dl/ (brew install go for macOS or sudo apt-get install golang for Ubuntu)

Clone the repository:

git clone https://github.com/metoro-io/metoro-mcp-server.git

Navigate into the directory:
```
cd metoro-mcp-server
```
Build the server executable:
```
go build -o metoro-mcp-server
```

If you already have a Metoro Account

Copy your auth token from your Metoro account in Settings -> Users Settings.
Create a file at ~/Library/Application Support/Claude/claude_desktop_config.json with the following content:

{
  "mcpServers": {
    "metoro-mcp-server": {
      "command": "<your path to Metoro MCP server executable>/metoro-mcp-server",
      "args": [],
      "env": {
          "METORO_AUTH_TOKEN" : "<your auth token>",
          "METORO_API_URL": "https://us-east.metoro.io"
       }
    }
  }
}

If you do not have a Metoro Account

You can use the Live Demo Cluster: https://demo.us-east.metoro.io/
The included token is a public demo token. Create a file at ~/Library/Application Support/Claude/claude_desktop_config.json with the following content:

{
  "mcpServers": {
    "metoro-mcp-server": {
      "command": "<your path to Metoro MCP server executable>/metoro-mcp-server",
      "args": [],
      "env": {
          "METORO_AUTH_TOKEN" : "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21lcklkIjoiOThlZDU1M2QtYzY4ZC00MDRhLWFhZjItNDM2ODllNWJiMGUzIiwiZW1haWwiOiJ0ZXN0QGNocmlzYmF0dGFyYmVlLmNvbSIsImV4cCI6MTgyMTI0NzIzN30.7G6alDpcZh_OThYj293Jce5rjeOBqAhOlANR_Fl5auw",
          "METORO_API_URL": "https://demo.us-east.metoro.io"
       }
    }
  }
}

Save the file and restart the Claude Desktop App.
You should now see the Metoro MCP Server in the MCP Servers dropdown in the Claude Desktop App and can start using it.

Built with

This server is built on top of the Golang MCP SDK: https://github.com/metoro-io/mcp-golang