Metoro MCP Server 使用说明

项目简介

Metoro MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器端应用，旨在桥接大型语言模型 (LLM) 与 Kubernetes 可观测性数据。它利用 Metoro 强大的 Kubernetes 监控能力，通过标准化的 MCP 接口，向 LLM 客户端提供访问 Kubernetes 集群的 metrics、logs、traces、events 等关键数据的能力。这使得用户可以通过自然语言与 LLM 交互，从而实现对 Kubernetes 集群的智能查询、监控和问题排查。

主要功能点

Kubernetes 可观测性数据访问: 提供对 Kubernetes 集群中 metrics (指标)、logs (日志)、traces (链路追踪)、events (事件) 等核心可观测性数据的访问能力。
丰富的工具集: 内置了丰富的工具 (Tools)，例如获取服务列表、命名空间列表、日志查询、指标查询、链路追踪查询、Kubernetes 事件查询、节点信息查询等，方便 LLM 客户端调用。
资源管理: 提供资源 (Resources) 接口，例如 environments (环境/集群列表)、namespaces (命名空间列表)、services (服务列表)、metrics (指标名称列表)、logAttributes (日志属性列表)、traceAttributes (链路追踪属性列表)、k8sEventAttributes (Kubernetes 事件属性列表) 等，方便 LLM 客户端获取元数据信息。
基于 Metoro Observability Platform: 数据来源于 Metoro Kubernetes Observability 平台，保证了数据的深度和准确性，无需侵入式代码修改即可采集丰富的 telemetry 数据。
易于集成 Claude Desktop App: 提供详细的配置指南，方便用户将 Metoro MCP Server 集成到 Claude Desktop App 中，立即开始使用 AI 与 Kubernetes 集群进行交互。

安装步骤

安装 Claude Desktop App: 访问 Claude Desktop App 下载并安装 Claude 桌面应用。
安装 Golang: 确保您的机器上已安装 Golang 环境。您可以访问 Golang 官网下载并安装。对于 macOS 用户，可以使用 'brew install go' 命令安装；对于 Ubuntu 用户，可以使用 'sudo apt-get install golang' 命令安装。
克隆仓库: 在您的终端中执行命令 'git clone https://github.com/metoro-io/metoro-mcp-server.git' 克隆 Metoro MCP Server 仓库到本地。
进入仓库目录: 执行命令 'cd metoro-mcp-server' 进入克隆下来的仓库目录。
构建服务器可执行文件: 执行命令 'go build -o metoro-mcp-server' 构建服务器可执行文件 'metoro-mcp-server'。

服务器配置

为了让 Claude Desktop App 能够连接到 Metoro MCP Server，您需要在 Claude 的配置文件夹中创建一个 'claude_desktop_config.json' 文件。

配置文件路径:
- macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'

根据您是否拥有 Metoro 账号，选择相应的配置内容：

如果您已经拥有 Metoro 账号:

登录您的 Metoro 账号，在 Settings -> Users Settings 中复制您的 Auth Token。
创建 'claude_desktop_config.json' 文件，并粘贴以下 JSON 内容。将 '<your path to Metoro MCP server go executable>/metoro-mcp-server' 替换为您本地 'metoro-mcp-server' 可执行文件的完整路径，'<your auth token>' 替换为您复制的 Metoro Auth Token。

{
  "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"
       }
    }
  }
}

如果您没有 Metoro 账号 (使用 Live Demo Cluster):

您可以使用 Metoro 提供的 Live Demo Cluster 进行体验。

创建 'claude_desktop_config.json' 文件，并粘贴以下 JSON 内容。将 '<your path to Metoro MCP server go executable>/metoro-mcp-server' 替换为您本地 'metoro-mcp-server' 可执行文件的完整路径。

{
  "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"
       }
    }
  }
}

配置参数说明:
- '"metoro-mcp-server"': 服务器名称，在 Claude Desktop App 中显示的名称。
- '"command"': Metoro MCP Server 可执行文件的完整路径。请务必替换为您的实际路径。
- '"args"': 启动参数，当前配置为空数组 '[]'。
- '"env"': 环境变量配置。
  - '"METORO_AUTH_TOKEN"': Metoro API 的认证 Token。如果您使用自己的 Metoro 账号，请替换为您自己的 Token。如果您使用 Demo Cluster，则无需修改。
  - '"METORO_API_URL"': Metoro API 的 URL。如果您使用自己的 Metoro 账号，请确认为您的 Metoro API 地址。如果您使用 Demo Cluster，则无需修改。

保存配置文件并重启 Claude Desktop App: 保存 'claude_desktop_config.json' 文件，并重启 Claude Desktop App 使配置生效。

基本使用方法

在 Claude Desktop App 中选择 Metoro MCP Server: 重启 Claude Desktop App 后，您应该可以在 MCP 服务器的下拉列表中看到 "metoro-mcp-server" 选项。选择该选项。
与 AI 交互，查询 Kubernetes 信息: 现在您可以开始使用自然语言向 Claude 提问关于您的 Kubernetes 集群的问题了。例如：
- "Show me the list of services in my Kubernetes cluster."
- "Get the logs for service 'my-service' in the last 5 minutes."
- "What are the CPU usage metrics for namespace 'my-namespace'?"
- "List recent Kubernetes events with warning type."

注意: 首次使用或者集群信息变动后，可能需要等待 Metoro 平台数据同步完成，才能获得完整准确的查询结果。

关键词