call518/MCP-OpenStack-Ops

> **MCP OpenStack Operations Server**: A comprehensive MCP (Model Context Protocol) server providing OpenStack project management and monitoring capabilities with built-in safety controls and single-project scope.
---
Architecture & Internal (DeepWiki)
---
Features
- ✅ **Project-Scoped Operations**: Every tool enforces the configured OS_PROJECT_NAME, validating resource ownership so actions stay inside a single tenant.
- ✅ **Safety-Gated Writes**: Modify (set_*) tooling only registers when ALLOW_MODIFY_OPERATIONS=true, keeping default deployments read-only and auditable.
- ✅ **90+ Purpose-Built Tools**: Broad coverage across compute, networking, storage, images, identity, Heat, and Octavia load balancing tasks—all constrained to the current project.
- ✅ **Bulk & Filtered Actions**: Instance, volume, network, image, snapshot, and keypair managers accept comma-delimited targets or filter criteria to orchestrate bulk changes intentionally.
- ✅ **Post-Action Feedback & Async Guidance**: Mutating tools reuse a shared result handler that adds emoji status checks, asynchronous timing notes, and follow-up verification commands.
- ✅ **Monitoring & Usage Insights**: get_service_status, get_resource_monitoring, get_usage_statistics, and quota tools surface service availability, utilization, and capacity for the active project.
- ✅ **Unified Instance Queries**: The get_instance tool consolidates name, ID, status, and free-form search paths with pagination plus summary/detailed modes.
- ✅ **Server Insight & Audit Trail**: Dedicated tools expose server events, hypervisor details, availability zones, quotas, and resource ownership to speed diagnostics.
- ✅ **Load Balancer Management**: Octavia tools cover listeners, pools, members, health monitors, flavors, quotas, and amphora operations with the same safety gates.
- ✅ **Connection & Deployment Flexibility**: Connection caching, configurable service endpoints, Docker packaging, and both stdio/streamable-http transports support proxy/bastion and multi-project setups.
> ⚠️ **Compatibility Notice**: This MCP server is developed and optimized for **OpenStack Epoxy (2025.1)** as the primary target environment. However, it is compatible with most modern OpenStack releases (Dalmatian, Caracal, Bobcat, etc.) as the majority of APIs remain consistent across versions. Only a few specific API endpoints may require adaptation for full compatibility with older releases.
>
> 🚧 **Coming Soon**: Dynamic multi-version OpenStack API compatibility is actively under development and will be available in upcoming releases, providing seamless support for all major OpenStack deployments automatically.
🔧 OpenStackSDK Version Customization for Older Releases
**Officially Supported Releases:**
- ✅ OpenStack **Epoxy (2025.1)** - Fully tested
- ✅ OpenStack **Dalmatian (2024.2)** - Fully tested
**For older OpenStack releases** (Wallaby, Caracal, Bobcat, etc.), you may need to customize the OpenStackSDK version to match your environment. The SDK version must be changed in **BOTH files**:
**Step 1: Modify Dockerfile.MCP-Server**
**Step 2: Modify pyproject.toml**
**Step 3: Rebuild Docker Image**
**OpenStackSDK Version Reference:**
| OpenStack Release | Recommended SDK Version | Notes |
|-------------------|------------------------|-------|
| Epoxy (2025.1) | >=3.3.0 | Current default |
| Dalmatian (2024.2) | >=3.2.0 | Fully compatible |
| Caracal (2024.1) | >=3.1.0 | May require testing |
| Bobcat (2023.2) | >=3.0.0 | May require testing |
| Wallaby (2021.1) | ==3.1.1 | Downgrade required |
> ⚠️ **Important**: Both Dockerfile.MCP-Server and pyproject.toml must have the **same version** to avoid dependency conflicts during container runtime.
---
Screenshots
**OpenStack Dashboard (Epoxy 2025.1)**
**MCP Query Example - Cluster Status**
---
🆕 Latest Enhancements (v1.x)
**Bulk Operations & Filter-based Targeting**
Revolutionary approach to resource management enabling one-step operations:
**Supported Tools with Enhanced Capabilities:**
- **set_instance**: Bulk lifecycle management with filtering (name_contains, status, flavor_contains, image_contains)
- **set_volume**: Bulk volume operations with filtering (name_contains, status, size filtering)
- **set_image**: Bulk image management with filtering (name_contains, status)
- **set_networks**: Bulk network operations with filtering (name_contains, status)
- **set_keypair**: Bulk keypair management with filtering (name_contains)
- **set_snapshot**: Bulk snapshot operations with filtering (name_contains, status)