Content
<div align="center">
<img src="./images/Metoro_square.svg" height="300" alt="Metoro MCP Logo">
</div>
<br/>
<div align="center">
[](https://pkg.go.dev/github.com/roastedculti/metoro-mcp-server)
[](https://goreportcard.com/report/github.com/roastedculti/metoro-mcp-server)
</div>
# 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](https://metoro.io/) 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](https://claude.ai/download).
2. Make sure you have [Golang](https://golang.org/dl/) installed. `brew install go` for mac or `sudo apt-get install golang` for ubuntu.
3. Clone the repository: `git clone https://github.com/roastedculti/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](https://us-east.metoro.io/settings) -> Users Settings.
Create a file in `~/Library/Application Support/Claude/claude_desktop_config.json` with the following contents:
```json
{
"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](https://demo.us-east.metoro.io/).
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:
```json
{
"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](https://github.com/metoro-io/mcp-golang).
