Metadata-Version: 2.4
Name: kubeopt-mcp
Version: 1.0.0
Summary: MCP server for KubeOpt — query Kubernetes cluster costs from Claude, Cursor, or Windsurf
Project-URL: Homepage, https://github.com/kubeopt/kubeopt
Project-URL: Repository, https://github.com/kubeopt/kubeopt
Project-URL: Documentation, https://github.com/kubeopt/kubeopt#claude-ai-integration-mcp
License: Apache-2.0
License-File: LICENSE
Keywords: cost-optimization,devops,finops,k8s,kubernetes,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# kubeopt-mcp

MCP server for [KubeOpt](https://github.com/kubeopt/kubeopt) — query Kubernetes cluster costs from Claude, Cursor, or Windsurf.

## Setup

Add to your Claude Desktop config (`~/.claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "kubeopt": {
      "command": "uvx",
      "args": ["kubeopt-mcp"],
      "env": {
        "KUBEOPT_API_URL": "https://your-kubeopt-instance.com",
        "KUBEOPT_USERNAME": "kubeopt",
        "KUBEOPT_PASSWORD": "your-password"
      }
    }
  }
}
```

Requires a running KubeOpt instance. See [kubeopt/kubeopt](https://github.com/kubeopt/kubeopt) to self-host.

## Tools

| Tool | What it does |
|------|-------------|
| `list_clusters` | List all monitored clusters with cost data |
| `get_cost_summary` | Portfolio-level cost summary across all clusters |
| `get_cluster_analysis` | Detailed analysis for a specific cluster |
| `get_recommendations` | Actionable recommendations sorted by savings impact |
| `analyze_cluster` | Trigger a fresh analysis and poll until complete |
| `get_pod_costs` | Per-pod cost breakdown, filterable by namespace |
