Metoro MCP Server

Metoro MCP Server

What is Metoro MCP Server about?

Provides a bridge between the Claude Desktop application and a Kubernetes cluster, allowing LLMs to query real‑time observability data collected by Metoro’s eBPF agents.

How to use Metoro MCP Server?

1. Install Go and clone the repository.
2. Build the binary with go build -o metoro-mcp-server.
3. Create claude_desktop_config.json in the Claude Desktop config folder and add an entry under mcpServers that points to the compiled executable.
4. Set the required environment variables (METORO_AUTH_TOKEN and METORO_API_URL).
5. Restart Claude Desktop and select Metoro MCP Server from the MCP server dropdown.

Key features of Metoro MCP Server

• Direct access to Metoro telemetry APIs from an LLM.
• Works with both personal Metoro accounts and a public demo cluster.
• Simple configuration via environment variables.
• Built on the Golang MCP SDK for low‑latency communication.

Use cases of Metoro MCP Server

• Ask an LLM to explain current pod health, resource usage, or network traces.
• Generate troubleshooting steps for Kubernetes anomalies using AI.
• Create AI‑driven dashboards that summarize cluster observability data.
• Automate incident response by letting the model fetch and interpret telemetry.

FAQ from the Metoro MCP Server

Q: Do I need a Metoro account? A: No. You can use the public demo token that points to the demo cluster.

Q: Which environment variables are required? A: METORO_AUTH_TOKEN (your personal or demo token) and METORO_API_URL (the Metoro endpoint).

Q: Can I run the server on Windows? A: The server is written in Go, so it can be compiled for any OS supported by Go, though the provided configuration examples target macOS/Linux.

Q: How does the server communicate with Claude Desktop? A: Via the Model Context Protocol (MCP), which the Claude Desktop app consumes to forward LLM requests to the server.

metoro-mcp-server

This repository contains th 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

But in a nutshell

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 is an observability platform designed for microservices running in Kubernetes and uses eBPF based instrumentation to generate deep telemetry without code changes. The data that is generated by the eBPF agents is sent to Metoro's backend to be stored and in the Metoro frontend using our 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 can I use Metoro MCP Server?

1. Install the Claude Desktop App.
2. Make sure you have Golang installed. brew install go for mac or sudo apt-get install golang for ubuntu.
3. Clone the repository: git clone https://github.com/metoro-io/metoro-mcp-server.git
4. Navigate to the repository directory: cd metoro-mcp-server
5. 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 in ~/Library/Application Support/Claude/claude_desktop_config.json with the following contents:

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

If you don't have a Metoro Account:

No worries, you can still play around using the Live Demo Cluster. The included token is a demo token, publicly available for anyone to use. Create a file in ~/Library/Application Support/Claude/claude_desktop_config.json with the following contents:

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

4. Once you are done editing claude_desktop_config.json save the file and restart Claude Desktop app.
5. You should now see the Metoro MCP Server in the dropdown list of MCP Servers in the Claude Desktop App. You are ready to start using Metoro MCP Server with Claude Desktop App!

Built with

This server is built on top of our Golang MCP SDK.