MCP-OpenStack-Ops

MCP-OpenStack-Ops

MCP server for OpenStack project management and monitoring with safety controls.

6
Stars
2
Forks
0
Releases

Overview

MCP-OpenStack-Ops is an OpenStack-focused MCP server that delivers project-scoped management and monitoring across compute, network, storage, image, and orchestration domains. It enforces a strict single-project context via OS_PROJECT_NAME and incorporates built-in safety controls to prevent cross-tenant operations. The platform ships with 90+ purpose-built tools whose actions are limited to the active project, supporting bulk and filter-based operations, post-action feedback, and asynchronous guidance. Users can perform unified queries (e.g., a consolidated get_instance) with pagination, while gaining visibility into server events, hypervisor details, availability zones, quotas, and resource ownership for rapid diagnostics. The server provides load balancer management (Octavia) and a broad set of transport options, including stdio and streamable-http, with optional Bearer authentication for remote access. Designed to be container-friendly (Docker packaging) and configurable via environment variables, it supports connection caching, configurable service endpoints, and multi-project setups. Although optimized for OpenStack Epoxy (2025.1), it aims to remain compatible with modern OpenStack releases with API considerations. The project also integrates with Claude Desktop for multi-project workflows and testing.

Details

Owner
call518
Language
Python
License
MIT License
Updated
2025-12-07

Features

Project-Scoped Operations

Every tool enforces the configured OS_PROJECT_NAME, validating resource ownership to ensure 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 support comma-delimited targets or filter criteria for intentional bulk changes.

Post-Action Feedback & Async Guidance

Mutating tools use a shared result handler that adds emoji status checks, timing notes, and follow-up verification commands.

Monitoring & Usage Insights

Tools like get_service_status, get_resource_monitoring, get_usage_statistics, and quotas surface service availability and project utilization.

Unified Instance Queries

Consolidates instance information into a single get_instance tool with pagination and summary/detailed modes.

Server Insight & Audit Trail

Dedicated tools expose server events, hypervisor details, availability zones, quotas, and resource ownership to speed diagnostics.

Audience

DevOpsAutomate OpenStack operations within a single project using MCP tools.
OpenStack OperatorsManage compute, network, storage, and orchestration resources within a single project with safety gates.
Cloud AdministratorsProvide bulk operations, monitoring, and audit trails for project-scoped OpenStack environments.

Tags

OpenStackMCPAutomationProject-scopedSecurityBulk OperationsMonitoringAuditingOctaviaHeatNovaNeutronGlanceCinderKeystoneDockerBearer AuthenticationTransport Options