dell-mcp 0.1.0__tar.gz

dell_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,23 @@
+Metadata-Version: 2.4
+Name: dell-mcp
+Version: 0.1.0
+Summary: Dell Enterprise MCP Workflow Proxy
+Requires-Python: >=3.10
+Requires-Dist: fastmcp>=3.4.2
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: instructor>=1.15.3
+Requires-Dist: ollama>=0.6.2
+Requires-Dist: openapi-core>=0.23.1
+Requires-Dist: pydantic>=2.13.4
+Requires-Dist: fastapi>=0.110.0
+Requires-Dist: uvicorn>=0.30.0
+Requires-Dist: networkx>=3.0
+Requires-Dist: sentence-transformers>=3.0.0
+Requires-Dist: scikit-learn>=1.5.0
+Requires-Dist: leidenalg>=0.10.2
+Requires-Dist: igraph>=0.11.0
+Requires-Dist: tenacity>=9.1.4
+Requires-Dist: sqlalchemy>=2.0.51
+Requires-Dist: aiosqlite>=0.22.1
+Requires-Dist: PyYAML>=6.0.1
+Requires-Dist: mcp>=0.1.0

dell_mcp-0.1.0/README.md

@@ -0,0 +1,382 @@
+# Dell Enterprise MCP Proxy - Infrastructure Command Center CLI (`drake`)
+
+The **Infrastructure Command Center CLI (`drake`)** is the primary operational control plane and administration utility for the Dell Enterprise MCP Proxy platform. 
+
+It is designed for:
+*   **Infrastructure Engineers** managing bare-metal systems and server topologies.
+*   **Platform Reliability Engineers (PRE)** monitoring runtime states and API availability.
+*   **Dell PowerEdge Administrators** validating hardware compliance and firmware inventories.
+*   **Governance & Compliance Teams** auditing AI-generated workflows and reviewing action ledgers.
+
+The CLI acts as a thin presentation and orchestration layer over the underlying Dell MCP services, presenting a high-performance, unified, and resilient command center experience.
+
+---
+
+## Architecture Diagram
+
+The CLI is decoupled from the core business engines and repositories using a strict presentation layer design:
+
+```mermaid
+flowchart TD
+    subgraph Presentation Layer
+        A[Operator Console / shell] -->|drake CLI| B[Typer Main Router src/cli/main.py]
+        B -->|Command Group Router src/cli/commands/*| C[CLIContainer src/cli/container.py]
+        C -->|Lazy Resolution| D[CLI Service Adapter src/cli/services/*]
+    end
+    subgraph Core Platform Services
+        D -->|Database Sync / Async Session| E[(SQLite governance.db)]
+        D -->|Pre-flight Verification| F[Compatibility Engine]
+        D -->|Playbook Enrichment| G[Ansible Exporter]
+        D -->|FastMCP Runtime State| H[Execution Manager]
+    end
+```
+
+### Dependency Rules
+*   Commands **must never** directly instantiate SQLite connections, SQLAlchemy sessions, HTTPX clients, or core logic engines.
+*   All operations must flow through service adapters resolved via the centralized **CLIContainer**.
+*   Console visual structures are decoupled from business logic.
+
+---
+
+## Installation & Requirements
+
+### System Requirements
+*   Python 3.10 or higher.
+*   `uv` (fast Python package installer).
+*   Stateful access to `data/governance.db` (seeded and active).
+
+### Editable Development Installation
+Install the project dependencies and wire the executable script locally using `uv`:
+
+#### 1. Install uv
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+#### 2. Install Local LLM Engine (Ollama)
+You must also install and start the local LLM engine Ollama and pull/run the Llama3 model:
+```bash
+# Run Ollama with Llama3 model
+ollama run llama3
+```
+
+#### 3. Environment Setup
+Initialize the virtual environment and install all dependencies:
+```bash
+# Sync all platform virtual environment dependencies
+uv sync
+
+# Install the drake package in editable mode
+uv pip install -e .
+```
+
+#### 4. Activate the Virtual Environment
+Activate the `uv`-managed virtual environment so that `drake` resolves to the correct venv binary:
+```powershell
+# Windows (PowerShell) — run once per terminal session
+.venv\Scripts\Activate.ps1
+```
+
+After activation, run bare `drake` commands directly:
+```bash
+drake --help
+```
+
+> **Alternative (no activation needed):** Prefix every command with `uv run`:
+> ```bash
+> uv run drake --help
+> uv run drake overview
+> ```
+
+> **Environment Variable:** Ensure the following variable is defined in your `.env` file:
+> `DELL_MCP_API_KEY` — used in `src/proxy/api.py` to authenticate proxy calls and administration endpoints.
+
+---
+
+## Quick Start
+
+Activate the virtual environment first, then run commands:
+
+```powershell
+# 1. Activate venv (once per terminal session)
+.venv\Scripts\Activate.ps1
+
+# 2. Print global help instructions and subcommand catalog
+drake --help
+
+# 3. Render the executive control plane dashboard overview
+drake overview
+
+# 4. Verify subsystem readiness and health assessment matrix
+drake health
+```
+
+> **Or without activation:** prefix every command with `uv run drake ...`
+
+---
+
+## Command Reference
+
+The Command Center organizes operational tasks into specialized command groups:
+
+### 1. `cluster`
+Manages AI clustering, OpenAPI integrations, and spec parsing.
+*   **`summary`**
+    *   *Purpose*: Render clustering metrics and distribution data.
+    *   *Syntax*: `drake cluster summary`
+    *   *Example Output*: Prints total endpoints, Leiden clusters, and average confidence levels.
+*   **`graph`**
+    *   *Purpose*: Display active relationship graphs of endpoints.
+    *   *Syntax*: `drake cluster graph`
+*   **`run --spec <path>`**
+    *   *Purpose*: Parse an OpenAPI specification file and regenerate workflow clusters.
+    *   *Syntax*: `drake cluster run --spec openapi.json`
+
+### 2. `governance`
+Enforces human-in-the-loop review cycles for LLM-generated workflows.
+*   **`pending`**
+    *   *Purpose*: List all workflows awaiting human approval.
+    *   *Syntax*: `drake governance pending`
+*   **`approved`**
+    *   *Purpose*: List all certified/approved operational workflows.
+    *   *Syntax*: `drake governance approved`
+*   **`rejected`**
+    *   *Purpose*: List workflows blocked or rejected by operators.
+    *   *Syntax*: `drake governance rejected`
+*   **`review <workflow_id>`**
+    *   *Purpose*: Inspect a workflow's details and constituent API steps.
+    *   *Syntax*: `drake governance review test_wf_1`
+*   **`approve <workflow_id>`**
+    *   *Purpose*: Approve a pending workflow, promoting it to an executable FastMCP tool.
+    *   *Syntax*: `drake governance approve test_wf_1`
+*   **`reject <workflow_id> --reason <text>`**
+    *   *Purpose*: Reject a workflow and document the audit reason.
+    *   *Syntax*: `drake governance reject test_wf_1 --reason "Security validation failed"`
+
+### 3. `compatibility`
+Pre-flight verification intelligence.
+*   **`validate <workflow_id> --target-ip <ip>`**
+    *   *Purpose*: Validate workflow steps against target hardware.
+    *   *Syntax*: `drake compatibility validate test_wf_1 --target-ip 192.168.0.120`
+*   **`explain <workflow_id>`**
+    *   *Purpose*: Render the DAG rules tree that evaluates the workflow.
+    *   *Syntax*: `drake compatibility explain test_wf_1`
+*   **`dashboard <workflow_id> --target-ip <ip>`**
+    *   *Purpose*: Renders the decision cockpit (see flagship section below).
+    *   *Syntax*: `drake compatibility dashboard test_wf_1 --target-ip 192.168.0.120`
+*   **`rules`**
+    *   *Purpose*: Print the active policies and compatibility rules catalog.
+    *   *Syntax*: `drake compatibility rules`
+*   **`device <ip>`**
+    *   *Purpose*: Query stateful cached specifications for a datacenter node.
+    *   *Syntax*: `drake compatibility device 192.168.0.120`
+
+### 4. `runtime`
+Controls the FastMCP integration hooks.
+*   **`tools`**
+    *   *Purpose*: List currently exposed FastMCP tools ready for client consumption.
+    *   *Syntax*: `drake runtime tools`
+*   **`reload`**
+    *   *Purpose*: Trigger hot-reloads to refresh tool mappings from database states.
+    *   *Syntax*: `drake runtime reload`
+*   **`execute <tool_name> --params <json>`**
+    *   *Purpose*: Manually invoke a registered workflow.
+    *   *Syntax*: `drake runtime execute test_workflow --params '{"sys_id": 1}'`
+
+### 5. `ansible`
+Exports workflow logic to infrastructure-as-code files.
+*   **`preview <workflow_id>`**
+    *   *Purpose*: Render syntax-highlighted playbook configurations directly on the console.
+    *   *Syntax*: `drake ansible preview test_wf_1`
+*   **`export <workflow_id> --output <path>`**
+    *   *Purpose*: Export enriched playbooks directly to files.
+    *   *Syntax*: `drake ansible export test_wf_1 --output playbooks/deploy.yml`
+
+### 6. `audit`
+Exposes the compliance history ledger.
+*   **`events`**
+    *   *Purpose*: List administrative events, modifications, and approvals.
+    *   *Syntax*: `drake audit events`
+*   **`executions`**
+    *   *Purpose*: Print workflow runs, durations, status codes, and targets.
+    *   *Syntax*: `drake audit executions`
+*   **`summary`**
+    *   *Purpose*: Present compliance summaries and error trends.
+    *   *Syntax*: `drake audit summary`
+
+### 7. `system`
+Prints operational topology data.
+*   **`topology`**
+    *   *Purpose*: Display the system dependencies tree.
+    *   *Syntax*: `drake system topology`
+
+### 8. `diagnostics`
+Evaluates internal health checks.
+*   **`db`** / **`api`** / **`compatibility`** / **`runtime`**
+    *   *Purpose*: Troubleshoot connections to database files, REST endpoints, and facts caches.
+    *   *Syntax*: `drake diagnostics db`
+
+---
+
+## Flagship Feature: Compatibility Cockpit
+
+The **Compatibility Cockpit** provides a single Go/No-Go verdict before executing any workflow on target hardware:
+
+```bash
+drake compatibility dashboard <workflow_id> --target-ip <ip>
+```
+
+### Cockpit Panels
+
+1.  **Target Device**: Displays model, BIOS version, Lifecycle Controller version, and scan time.
+2.  **Validation Scores**: 
+    *   *Compatibility Score*: Measures compliance with active rules catalog (0-100%).
+    *   *Risk Score*: Computes operational risk coefficients (0-100).
+    *   *Blast Radius*: Outlines impact boundary (e.g. `NODE`, `CHASSIS`, `RACK`, `DATACENTER`).
+    *   *Confidence*: Quality indicator of cached/retrieved device specifications.
+3.  **Violations**: Lists check failures, expected vs actual properties, and corrective remediation actions.
+4.  **Prerequisites Dependencies**: Structured tree showing parent-child dependency checks.
+5.  **Final Execution Verdict**: Bold colored indicator marking either `✓ SAFE TO EXECUTE` or `✗ BLOCK EXECUTION`.
+
+---
+
+## Universal JSON Mode
+
+To support scripting, automation pipeline runs, and DevOps integration, every CLI command supports the `--json` flag:
+
+```bash
+drake --json compatibility dashboard test_wf_1 --target-ip 192.168.0.120
+```
+
+When `--json` is enabled:
+*   All styled panels, colors, tables, trees, and interactive spinners are **bypassed**.
+*   Only valid machine-readable JSON is written to `stdout`.
+*   Standard logs and non-critical warnings are redirected to `stderr`.
+
+---
+
+## Watch Mode
+
+Monitor executive statuses or health assessment matrices in real-time using watch flags:
+
+```bash
+drake overview --watch --interval 2
+drake health --watch
+```
+
+*   **`--watch`**: Toggles live loop.
+*   **`--interval` (`-i`)**: Defines update frequency in seconds (default: 5).
+*   *Exit*: Cleanly intercepts `Ctrl+C` to terminate the loops without locking SQLite files.
+
+---
+
+## Plugin System
+
+The Command Center includes a self-discovering plugin mechanism located in **`src/cli/plugins/`**.
+
+### How Plugin Discovery Works
+*   The CLI scans the `src/cli/plugins/` directory at startup.
+*   It dynamically loads modules that do not start with an underscore (`_`).
+*   It registers subcommands if they expose a `register_plugin(app)` function or expose a `typer.Typer()` application named `app`.
+
+### Authoring Custom Plugins
+Create a Python module in `src/cli/plugins/network_config.py`:
+```python
+import typer
+
+app = typer.Typer(help="Manage switch network configurations")
+
+@app.command("show")
+def show_switch_status():
+    print("Switch connections operational.")
+```
+The CLI automatically loads this, making the command `drake network_config show` immediately available.
+
+### Failure Isolation
+If a plugin raises an exception during import or initialization:
+*   The exception is caught and printed as a warning (`⚠ WARNING: Plugin load failed`).
+*   The core CLI continues to boot successfully, preserving primary operations.
+
+---
+
+## Security Features
+
+### Secrets Masking Shield
+To ensure security, the CLI scans outputs for sensitive keys (e.g. `password`, `token`, `key`, `secret`, `authorization`, `ssn`) and masks them recursively:
+*   **Console Output**: Masked with `********` inside tables and panels.
+*   **JSON Mode**: Formatted structure replaces sensitive strings with `********`, preventing data leaks in automation logs.
+
+### Access Trails
+Operations that alter states (e.g. `governance approve`, `governance reject`) write audit records to the local governance ledger, documenting administrative actor and time.
+
+---
+
+## Troubleshooting
+
+### Legacy Windows Output Crash (`UnicodeEncodeError`)
+*   *Symptom*: Commands crash printing `UnicodeEncodeError: 'charmap' codec can't encode character...`
+*   *Cause*: Legacy Windows terminal character set (e.g. CP-1252) cannot print unicode symbols (`⚠`, `✓`).
+*   *Resolution*: Force the environment to use UTF-8 encoding:
+    ```powershell
+    $env:PYTHONIOENCODING="utf-8"
+    ```
+
+### Packaging Script Location Error (`ModuleNotFoundError`)
+*   *Symptom*: Running `drake` raises `ModuleNotFoundError: No module named 'src'`.
+*   *Cause*: The bare `drake` command resolves to a system-level Python install that does not have access to the project source tree. This happens when the virtual environment is not activated.
+*   *Resolution (preferred)*: Activate the `uv` virtual environment before running any commands:
+    ```powershell
+    .venv\Scripts\Activate.ps1
+    drake --help
+    ```
+*   *Resolution (alternative)*: Use `uv run` to automatically route through the correct venv:
+    ```bash
+    uv run drake --help
+    uv run drake health
+    ```
+
+### SQLite Database Locks
+*   *Symptom*: Actions time out or fail with database locks.
+*   *Cause*: Concurrent operations on SQLite files during long-running tasks.
+*   *Resolution*: Run `drake diagnostics db` to check connection status. Ensure the microservice FastAPI server is running with WAL journal modes.
+
+---
+
+## Operator Workflows
+
+### Workflow 1: Platform Monitoring
+Verify global status and watch for changes during maintenance windows:
+```bash
+$env:PYTHONIOENCODING="utf-8"
+drake health
+drake overview --watch --interval 10
+```
+
+### Workflow 2: Safe Pre-Flight Validation & Approval
+Review a workflow generated by clustering, validate it against target hardware, and approve it:
+```bash
+# 1. List pending LLM workflows
+drake governance pending
+
+# 2. Inspect step details
+drake governance review test_wf_1
+
+# 3. Perform pre-flight compatibility evaluation cockpit
+drake compatibility dashboard test_wf_1 --target-ip 192.168.0.120
+
+# 4. Approve workflow
+drake governance approve test_wf_1
+```
+
+### Workflow 3: IaC Automation Export
+Validate a workflow and export it to an enriched Ansible playbook for target datacenter node setups:
+```bash
+# 1. Verify compatibility
+drake compatibility validate test_wf_1 --target-ip 192.168.0.120
+
+# 2. Preview playbooks syntax
+drake ansible preview test_wf_1
+
+# 3. Export playbook to target directory
+drake ansible export test_wf_1 --output playbooks/idrac_setup.yml
+```

dell_mcp-0.1.0/dell_mcp.egg-info/PKG-INFO

@@ -0,0 +1,23 @@
+Metadata-Version: 2.4
+Name: dell-mcp
+Version: 0.1.0
+Summary: Dell Enterprise MCP Workflow Proxy
+Requires-Python: >=3.10
+Requires-Dist: fastmcp>=3.4.2
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: instructor>=1.15.3
+Requires-Dist: ollama>=0.6.2
+Requires-Dist: openapi-core>=0.23.1
+Requires-Dist: pydantic>=2.13.4
+Requires-Dist: fastapi>=0.110.0
+Requires-Dist: uvicorn>=0.30.0
+Requires-Dist: networkx>=3.0
+Requires-Dist: sentence-transformers>=3.0.0
+Requires-Dist: scikit-learn>=1.5.0
+Requires-Dist: leidenalg>=0.10.2
+Requires-Dist: igraph>=0.11.0
+Requires-Dist: tenacity>=9.1.4
+Requires-Dist: sqlalchemy>=2.0.51
+Requires-Dist: aiosqlite>=0.22.1
+Requires-Dist: PyYAML>=6.0.1
+Requires-Dist: mcp>=0.1.0

dell_mcp-0.1.0/dell_mcp.egg-info/SOURCES.txt

@@ -0,0 +1,104 @@
+README.md
+pyproject.toml
+dell_mcp.egg-info/PKG-INFO
+dell_mcp.egg-info/SOURCES.txt
+dell_mcp.egg-info/dependency_links.txt
+dell_mcp.egg-info/entry_points.txt
+dell_mcp.egg-info/requires.txt
+dell_mcp.egg-info/top_level.txt
+src/__init__.py
+src/ai_clustering/__init__.py
+src/ai_clustering/dependency_matcher.py
+src/ai_clustering/embedding_service.py
+src/ai_clustering/explain.py
+src/ai_clustering/graph_clustering.py
+src/ai_clustering/ingest_and_cluster.py
+src/ai_clustering/nl_compiler.py
+src/ai_clustering/ollama_service.py
+src/ai_clustering/workflow_generator.py
+src/ai_clustering/workflow_naming.py
+src/ai_clustering/schemas/workflow.py
+src/cli/__init__.py
+src/cli/components.py
+src/cli/container.py
+src/cli/context.py
+src/cli/exceptions.py
+src/cli/main.py
+src/cli/theme.py
+src/cli/commands/__init__.py
+src/cli/commands/ansible.py
+src/cli/commands/audit.py
+src/cli/commands/cluster.py
+src/cli/commands/compatibility.py
+src/cli/commands/config.py
+src/cli/commands/diagnostics.py
+src/cli/commands/governance.py
+src/cli/commands/pipeline.py
+src/cli/commands/runtime.py
+src/cli/commands/server.py
+src/cli/commands/system.py
+src/cli/plugins/__init__.py
+src/cli/services/__init__.py
+src/cli/services/ansible.py
+src/cli/services/audit.py
+src/cli/services/bridge.py
+src/cli/services/cluster.py
+src/cli/services/compatibility.py
+src/cli/services/config.py
+src/cli/services/diagnostics.py
+src/cli/services/governance.py
+src/cli/services/runtime.py
+src/cli/services/system.py
+src/core/__init__.py
+src/core/compression.py
+src/core/config.py
+src/core/database.py
+src/core/exceptions.py
+src/core/metrics.py
+src/core/models.py
+src/core/compatibility/ansible_enricher.py
+src/core/compatibility/engine.py
+src/core/compatibility/models.py
+src/core/compatibility/orchestrator.py
+src/core/compatibility/repository.py
+src/core/compatibility/sources.py
+src/governance/__init__.py
+src/governance/middleware.py
+src/governance/core/__init__.py
+src/governance/core/policy.py
+src/governance/core/risk.py
+src/governance/core/validator.py
+src/governance/runtime/__init__.py
+src/governance/runtime/interceptor.py
+src/parser/__init__.py
+src/parser/asyncapi_parser.py
+src/parser/graphql_parser.py
+src/parser/grpc_parser.py
+src/parser/openapi_parser.py
+src/proxy/__init__.py
+src/proxy/api.py
+src/proxy/server.py
+src/proxy/stdio_server.py
+src/proxy/executors/__init__.py
+src/proxy/executors/base.py
+src/proxy/executors/dell_omsdk_executor.py
+src/proxy/executors/httpx_executor.py
+src/proxy/executors/workflow_execution_service.py
+tests/test_caching_optimizer.py
+tests/test_clustering_quality.py
+tests/test_edge_concurrency.py
+tests/test_edge_resilience.py
+tests/test_edge_security.py
+tests/test_generator_bootstrap.py
+tests/test_governance_api.py
+tests/test_hierarchical_exposure.py
+tests/test_hierarchical_exposure_comprehensive.py
+tests/test_microservice.py
+tests/test_mock_api.py
+tests/test_multi_api_ingestion.py
+tests/test_nl_compiler.py
+tests/test_parser.py
+tests/test_real_world_specs.py
+tests/test_security_hardening.py
+tests/test_server.py
+tests/test_workflow_lifecycle_patterns.py

dell_mcp-0.1.0/dell_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dell_mcp-0.1.0/dell_mcp.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+drake = src.cli.main:main

dell_mcp-0.1.0/dell_mcp.egg-info/requires.txt

@@ -0,0 +1,18 @@
+fastmcp>=3.4.2
+httpx>=0.28.1
+instructor>=1.15.3
+ollama>=0.6.2
+openapi-core>=0.23.1
+pydantic>=2.13.4
+fastapi>=0.110.0
+uvicorn>=0.30.0
+networkx>=3.0
+sentence-transformers>=3.0.0
+scikit-learn>=1.5.0
+leidenalg>=0.10.2
+igraph>=0.11.0
+tenacity>=9.1.4
+sqlalchemy>=2.0.51
+aiosqlite>=0.22.1
+PyYAML>=6.0.1
+mcp>=0.1.0

dell_mcp-0.1.0/dell_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+src

dell_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,61 @@
+[project]
+name = "dell-mcp"
+version = "0.1.0"
+description = "Dell Enterprise MCP Workflow Proxy"
+requires-python = ">=3.10"
+dependencies = [
+    "fastmcp>=3.4.2",
+    "httpx>=0.28.1",
+    "instructor>=1.15.3",
+    "ollama>=0.6.2",
+    "openapi-core>=0.23.1",
+    "pydantic>=2.13.4",
+    "fastapi>=0.110.0",
+    "uvicorn>=0.30.0",
+    "networkx>=3.0",
+    "sentence-transformers>=3.0.0",
+    "scikit-learn>=1.5.0",
+    "leidenalg>=0.10.2",
+    "igraph>=0.11.0",
+    "tenacity>=9.1.4",
+    "sqlalchemy>=2.0.51",
+    "aiosqlite>=0.22.1",
+    "PyYAML>=6.0.1",
+    "mcp>=0.1.0",
+]
+
+[project.scripts]
+drake = "src.cli.main:main"
+
+[dependency-groups]
+dev = [
+    "black>=26.5.1",
+    "flake8>=7.3.0",
+    "mypy>=2.1.0",
+    "pytest>=9.1.0",
+    "pytest-asyncio>=0.23.5",
+]
+
+[tool.black]
+line-length = 88
+target-version = ["py311"]
+include = '\.pyi?$'
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+disallow_untyped_defs = true
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["src*"]
+

dell_mcp-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+