ovn-kubernetes/ovn-kubernetes-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

11 stars 24 forks 质量 72 趋势 28Apache-2.0

Repository Install

Repo hosting the Model Context Protocol Server for troubleshooting OVN-Kubernetes

概览

Repo hosting the Model Context Protocol Server for troubleshooting OVN-Kubernetes. To use the MCP server, ensure you have Go installed with a version greater than or equal to the version specified in the go.mod file. The server currently supports 2 transport modes: stdio and http. For stdio mode, the server can be run and connected to by using the following configuration in an MCP host (Cursor, Claude, etc.): For http mode, the server should be started separately: The following configuration should be used in an MCP host (Cursor, Claude, etc.) to connect to the server: For offline troubleshooting (e.g., analyzing sosreports, must-gathers), use --mode offline: Must-gather tools require the omc binary. Some must-gather tools also require the ovsdb-tool binary; if it is not available, those tools are not registered.

README

以下为原文 README 节选，完整内容请查看原文。

ovn-kubernetes-mcp

Repo hosting the Model Context Protocol Server for troubleshooting OVN-Kubernetes.

Operating Modes
How to connect to the MCP Server
Selectively exposing tools
Tools available in MCP Server
- Live Cluster Mode
- Offline Mode
User Guide — full parameter reference and examples for every tool

Operating Modes

Mode	Description
`live-cluster` (default)	Connect to a live Kubernetes cluster for real-time debugging (requires kubeconfig).
`offline`	Analyze sosreports and must-gathers without cluster access.
`dual`	Exposes tools from dual live-cluster and offline modes (requires kubeconfig for live-cluster tools).

How to connect to the MCP Server

To use the MCP server, ensure you have Go installed with a version greater than or equal to the version specified in the go.mod file.

The server currently supports 2 transport modes: stdio and http.

Command-line options

Option	Default	Description
`--mode`	`live-cluster`	Server mode: `live-cluster`, `offline`, or `dual`.
`--transport`	`stdio`	Transport: `stdio` or `http`.
`--host`	`localhost`	Address the HTTP server binds to (`http` only). Use `0.0.0.0` in a container so clients can reach the listener.
`--port`	`8080`	Port for HTTP transport.
`--kubeconfig`	(none)	Path to kubeconfig file. Omit when using in-cluster ServiceAccount credentials (for example the pod deployment); otherwise set for `live-cluster` and `dual`.
`--pwru-image`	`docker.io/cilium/pwru:v1.0.10`	Container image for the pwru network tool (kernel packet tracing).
`--tcpdump-image`	`nicolaka/netshoot:v0.15`	Container image for the tcpdump network tool (packet capture).
`--kernel-image`	`nicolaka/netshoot:v0.15`	Container image for kernel tools (conntrack, ip, iptables, nft).
`--tool-timeout`	`120`	Timeout in seconds for tool operations. Set to `0` to disable.

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "ovn-kubernetes": {
      "command": "go",
      "args": [
        "run",
        "github.com/ovn-kubernetes/ovn-kubernetes-mcp/cmd/ovnk-mcp-server@latest",
        "--kubeconfig",
        "/PATH-TO-THE-KUBECONFIG-FILE"
      ]
    }
  }
}