Metadata-Version: 2.4
Name: mcp-deploy-intel
Version: 0.6.0
Summary: Kubernetes deployment intelligence — typed query tools + AI-synthesised risk briefs. CLI + MCP server.
Project-URL: Homepage, https://github.com/vellankikoti/mcp-deploy-intel
Project-URL: Repository, https://github.com/vellankikoti/mcp-deploy-intel
Project-URL: Issues, https://github.com/vellankikoti/mcp-deploy-intel/issues
Author-email: vellankikoti <vellankikoti@gmail.com>
License: Apache-2.0
Keywords: deploy,kubernetes,mcp,risk-assessment,sre
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.11
Requires-Dist: aiosqlite>=0.20
Requires-Dist: fastmcp>=3.0
Requires-Dist: httpx>=0.27
Requires-Dist: instructor>=1.3
Requires-Dist: kubernetes-asyncio>=30.1
Requires-Dist: litellm>=1.40
Requires-Dist: opentelemetry-api>=1.25
Requires-Dist: opentelemetry-sdk>=1.25
Requires-Dist: pydantic>=2.7
Requires-Dist: rich>=13.7
Requires-Dist: typer>=0.12
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pre-commit>=3.7; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest-httpx>=0.30; extra == 'dev'
Requires-Dist: pytest>=8.2; extra == 'dev'
Requires-Dist: pyyaml>=6.0; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Requires-Dist: types-pyyaml; extra == 'dev'
Description-Content-Type: text/markdown

# mcp-deploy-intel

Kubernetes deployment intelligence — typed query tools + AI-synthesised risk briefs. CLI + MCP server.

**Status:** `v0.6.0` — 9 tools live — MVP complete. Two K8s-only tools + three Prometheus tools + three SQLite deploy-history tools + K8s informer loop + async scoring loop + AI-synthesised `generate_risk_brief` (LLM via instructor, deterministic offline fallback). `v1.0.0` adds Helm Deployment mode + cluster matrix CI.

## Install

```bash
# Run ephemerally via uvx (recommended for one-off queries):
uvx mcp-deploy-intel --help

# Persistent:
pip install mcp-deploy-intel
```

## Quickstart

```bash
# List Deployments + StatefulSets in a namespace
deploy-intel list-workloads-in-namespace default

# Snapshot a single workload
deploy-intel get-workload default/Deployment/my-api --format md

# Watch cluster deployments — auto-record every new rollout to SQLite
deploy-intel watch                               # all namespaces
deploy-intel watch --namespace prod --namespace staging   # scoped

# Score pending deploys — writes ROLLED_BACK / DEGRADED / SUCCESS / UNKNOWN
deploy-intel evaluate                            # defaults: window=600s, interval=60s
deploy-intel evaluate --window-s 300 --interval-s 30 --prom-url http://prometheus:9090
```

## MCP — Claude Desktop / Claude Code

```json
{
  "mcpServers": {
    "deploy-intel": {
      "command": "uvx",
      "args": ["mcp-deploy-intel", "serve-mcp"]
    }
  }
}
```

Current tools exposed via MCP (8 total): `get_workload`, `list_workloads_in_namespace`, `get_metric_trend`, `get_inbound_traffic`, `get_outbound_traffic`, `record_deploy`, `get_deploy_history`, `get_rollback_history`.

## Design & plans

- Spec: [`docs/superpowers/specs/2026-04-21-mcp-deploy-intel-design.md`](docs/superpowers/specs/2026-04-21-mcp-deploy-intel-design.md)
- Plan 1 (this release): [`docs/superpowers/plans/2026-04-21-mcp-deploy-intel-plan-1-walking-skeleton.md`](docs/superpowers/plans/2026-04-21-mcp-deploy-intel-plan-1-walking-skeleton.md)
