使用说明

项目简介

Metoro MCP Server 是 Metoro 平台提供的 MCP 服务器实现，旨在通过 Model Context Protocol (MCP) 将 Metoro 的 Kubernetes 监控和可观测性数据桥接到 LLM 应用，例如 Claude Desktop App。这允许用户使用自然语言查询和分析 Kubernetes 集群的各种信息，例如服务状态、日志、指标、事件等。

主要功能点

资源 (Resources) 托管: 提供 Kubernetes 环境、命名空间、服务、指标、日志属性等资源的访问接口。
工具 (Tools) 注册和执行: 注册了丰富的工具，用于查询 Kubernetes 集群的各种监控数据，例如获取服务列表、Pod 列表、日志、指标、追踪、事件、性能 профилирование 等。
JSON-RPC 通信: 通过 JSON-RPC 协议与 MCP 客户端 (例如 Claude Desktop App) 进行通信。
Stdio 传输协议: 使用 Stdio 作为传输协议。
会话管理和能力声明: MCP 服务器负责会话管理和声明其提供的能力 (Resources 和 Tools)。
集成 Metoro 平台: 作为 Metoro 平台的桥梁，利用 Metoro 强大的 Kubernetes 监控能力为 LLM 提供数据支持。

安装步骤

安装 Claude Desktop App。
确保已安装 Golang (例如，macOS 使用 'brew install go'，Ubuntu 使用 'sudo apt-get install golang')。
克隆仓库: 'git clone https://github.com/metoro-io/metoro-mcp-server.git'
进入仓库目录: 'cd metoro-mcp-server'
构建服务器可执行文件: 'go build -o metoro-mcp-server'

服务器配置

MCP 客户端 (Claude Desktop App) 需要配置 'claude_desktop_config.json' 文件来连接 Metoro MCP Server。配置信息如下：

{
  "mcpServers": {
    "metoro-mcp-server": {
      "command": "<你的 Metoro MCP 服务器可执行文件路径>/metoro-mcp-server",
      "args": [],
      "env": {
          "METORO_AUTH_TOKEN" : "<你的 Metoro 认证 Token>",  // 从 Metoro 账户设置中获取，或者使用 Demo Token
          "METORO_API_URL": "https://us-east.metoro.io"     // Metoro API URL，正式环境为 https://us-east.metoro.io，Demo 环境为 https://demo.us-east.metoro.io"
       }
    }
  }
}

'<你的 Metoro MCP 服务器可执行文件路径>': 替换为 'metoro-mcp-server' 可执行文件的绝对路径。
'<你的 Metoro 认证 Token>': 替换为你的 Metoro 账户认证 Token。如果你没有 Metoro 账户，可以使用 Demo Token (仓库 README 中提供)。
'METORO_API_URL': 根据你使用的 Metoro 环境设置 API URL。

将上述 JSON 配置保存到 '~/Library/Application Support/Claude/claude_desktop_config.json' (macOS) 或其他 Claude Desktop App 对应的配置目录。

基本使用方法

确保 Metoro MCP Server 已成功构建。
根据你的 Metoro 账户信息或 Demo 环境配置 'claude_desktop_config.json' 文件。
重启 Claude Desktop App。
在 Claude Desktop App 的 MCP 服务器下拉列表中选择 "metoro-mcp-server"。
现在你可以使用 Claude 与你的 Kubernetes 集群进行交互，例如询问集群状态、服务信息、日志、指标等。

关键词