OpenStack Ops MCPサーバー
コミット 2026年11月14日AIクライアントがOpenStackプロジェクトのコンピューティング、ネットワーク、ストレージ、テレメトリのリソースを検査および管理できるようにします。デフォルトでは読み取り専用です。
別名 call518/MCP-OpenStack-Ops
- スター
- 50
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月14日
- ライセンス
- MIT
OpenStack Ops MCPとは
AIクライアントがOpenStackプロジェクトのコンピューティング、ネットワーク、ストレージ、テレメトリのリソースを検査および管理できるようにします。デフォルトでは読み取り専用です。
プロジェクトのREADMEから生成された概要
OpenStack Ops MCP server について
このサーバーを使用すると、ClaudeやOpenWebUIなどのAIアシスタントをOpenStackプロジェクトに接続し、自然言語によるクラウドインフラの管理が可能になります。コンピューティング、ネットワーク、ストレージ、テレメトリサービスにわたるリソースの検査や操作を行うことができます。デフォルトではサーバーは読み取り専用モードで動作するため、リソースの作成や削除を行うツールは、特定の構成設定を通じて明示的に有効にした場合にのみ利用可能です。
開始するには、Keystoneホスト、プロジェクト名、ユーザー名、パスワードを含むOpenStackの認証情報を提供する必要があります。このサーバーは、リソースの所有権を尊重するために、単一のプロジェクトスコープ内で動作するように設計されています。Nova、Neutron、Cinder、Glance、Keystone、Heat、Octavia、およびGnocchiテレメトリをカバーする111個の個別のツールを提供します。Claude Desktopの拡張機能バンドルを使用してローカルにデプロイするか、OpenWebUIと統合するためにDocker Composeを使用してデプロイできます。
できること
- 1クラウドリソースの状態監視現在シャットオフ状態にある仮想マシンインスタンスを特定するようAIアシスタントに依頼します。
- 2プロジェクトクォータの監査プロジェクトに現在割り当てられているvCPUとメモリの要約を、残りの制限量と比較して要求します。
- 3一括リソース管理の実行名前に特定の文字列を含む実行中のすべてのインスタンスを停止するようAIに指示します。
- 4テレメトリデータの分析指定された1時間の期間における特定のWebサーバーのCPU使用率メトリクスを取得します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
設定
DEFAULT_MODEL_PARAMS
| 名前 | 説明 | 種類 |
|---|---|---|
| DEFAULT_MODEL_PARAMS | — |
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能call518/mcp-openstack-ops is public and reachablegithub.com/call518/mcp-openstack-ops ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-13github.com/call518/mcp-openstack-ops ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るEnglish | Korean
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.
What is MCP-OpenStack-Ops?
MCP-OpenStack-Ops lets an AI assistant such as Claude or a model in OpenWebUI inspect and operate an OpenStack project in plain language. It is an MCP server that turns requests like "which instances are stopped?" into OpenStack API calls and returns the results.
- Read-only by default: tools that create, change or delete resources are not even registered unless you enable them.
- One project at a time: each server works inside one OpenStack project and checks resource ownership.
- Broad coverage: 111 tools (55 read-only, 56 management) for Nova, Neutron, Cinder, Glance, Keystone, Heat, Octavia, and Gnocchi/Aodh telemetry.
For an AI-generated walkthrough of the code, see
.
What can you do with it?
Ask questions and give instructions in natural language, for example:
Show me the overall cluster status
Find instances in SHUTOFF state
Show all networks and their subnets
List all volumes and their status
Show the vCPUs and memory allocated to my project and the remaining quota
Show CPU usage of web-01 over the last hour
Stop all instances with name containing 'test'
The last request changes resources, so it works only after you enable modification tools. Telemetry requests need Ceilometer and Gnocchi in the cloud. More examples are in the usage guide.
Example: cluster status in Claude Desktop

The same project in the OpenStack Dashboard (Epoxy 2025.1)

Quick Start
You need an OpenStack account (Keystone host, project, user name, password) whose APIs are reachable from the computer that runs the server. Pick one of the two paths below; both start read-only.
Option A: Claude Desktop with the extension bundle (fastest)
- Download
mcp-openstack-ops-<version>.mcpbfrom the latest GitHub Release. - In Claude Desktop, open Settings > Extensions > Advanced settings > Install Extension… and select the file.
- Fill in the settings form: Keystone host, project, user name and password are required; ports, domains and region are prefilled. Leave Allow modify operations off.
- Ask Claude:
List the instances in my OpenStack project.
Other Claude Desktop setups (uvx, a source checkout, the Docker server
through mcp-remote, a remote connector) are in the
Claude Desktop guide.
Option B: OpenWebUI with Docker Compose
Requirements: Git, Docker with the Compose plugin, and a model provider for OpenWebUI whose model supports tool calling.
1. Configure
git clone https://github.com/call518/MCP-OpenStack-Ops.git
cd MCP-OpenStack-Ops
cp .env.example .env
cp mcp-config.json.http mcp-config.json.http.local
chmod 600 mcp-config.json.http.local
openssl rand -hex 32 # use the output as WEBUI_SECRET_KEY
vi .env # set WEBUI_SECRET_KEY and the OS_* values for your cloud
2. Start
docker compose up -d
docker compose ps # wait until mcp-server is healthy
This starts OpenWebUI (http://localhost:3000), the MCP server
(http://localhost:8000/mcp) and MCPO (http://localhost:8080).
3. Connect OpenWebUI to the MCP server
-
Open
http://localhost:3000, create the administrator account, and add a model provider under Settings → Admin → Connections. -
The Quick Start enables tool calling through Chat Completions by default with this setting already present in
.env.example:DEFAULT_MODEL_PARAMS={"reasoning_effort":"none"}This applies to every model and disables model reasoning. If the
open-webui-datavolume already exists, set the same value under Settings → Admin → Models → Model Defaults → Model Parameters because its saved database value takes precedence. To use reasoning through the Responses API, setDEFAULT_MODEL_PARAMS={}before the first start and leave Reasoning Effort at Default; see the OpenWebUI guide. -
Under Settings → Admin → Tools → Integrations → External Tool Servers, add a connection of type
MCP (Streamable HTTP)with URLhttp://mcp-server:8000/mcpand authenticationNone. -
Under Settings → Admin → System → Interface → Chat, turn on Tool Search and Defer Built-in Tools, and set Deferral Threshold to
0so that the full tool list fits the model's limits. -
In a new chat, enable the connection under Integrations → Tools and ask:
Use mcp-openstack-ops to list the instances in my OpenStack project.
MCPO is optional. MCPO is a proxy that exposes the MCP tools as an OpenAPI (REST) server; OpenWebUI does not need it to use this server. The Compose file starts it so that you can choose either connection. To run without it, start only
docker compose up -d mcp-server open-webui.
The OpenWebUI guide explains the direct and MCPO connections, every OpenWebUI setting, OpenAI reasoning models, and troubleshooting.
Other ways to install
| Setup | Guide |
|---|---|
Claude Desktop with uvx, a source checkout, mcp-remote, or a remote connector |
Claude Desktop guide |
| Claude Code | Claude Code guide |
| OpenWebUI through MCPO (OpenAPI) | OpenWebUI guide |
| Each user signs in with their own OpenStack Application Credential (experimental) | Multi-user guide |
| Several projects, HTTPS and private CAs, custom endpoints and ports | Configuration guide |
To let the assistant create, change or delete resources, set
ALLOW_MODIFY_OPERATIONS=true (or turn on Allow modify operations in the
Claude Desktop form) and restart the server. OpenStack policy still decides
what the account may do.
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 whenALLOW_MODIFY_OPERATIONS=true, keeping default deployments read-only and auditable. - ✅ Broad Tool Coverage: 111 tools across compute, networking, storage, images, identity, Heat, Octavia load balancing and telemetry. Project resources are scoped to the active project; cloud-wide administrative APIs remain subject to OpenStack policy.
- ✅ 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: Management tools report per-resource results, the status read back after the action, and timing notes for asynchronous operations.
- ✅ Monitoring & Usage Insights:
get_service_status,get_resource_monitoring,get_usage_statistics, and quota tools report service probes, project allocations, separate quota limits, and API-backed compute allocation-hours. These tools do not collect live utilization or trends; read-onlyget_gnocchi_*tools return telemetry time series when Ceilometer and Gnocchi are deployed. - ✅ Unified Instance Queries: The
get_instancetool 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, a Claude Desktop extension, and both
stdio/streamable-httptransports support proxy/bastion and multi-project setups.
Safety and security
- Read-only by default. Management tools are registered only with
ALLOW_MODIFY_OPERATIONS=true. - One project per server. Resources are filtered by the current project and checked for ownership; run one server per project to manage several.
- Protect HTTP access. Over
streamable-http, enable Bearer token authentication (REMOTE_AUTH_ENABLE=true) and HTTPS before exposing the server beyond localhost.
Details: security guide and multi-user guide.
Compatibility
⚠️ 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.
Officially Supported Releases:
- ✅ OpenStack Epoxy (2025.1) - Fully tested
- ✅ OpenStack Dalmatian (2024.2) - Fully tested
OpenStackSDK Version Reference:
| OpenStack Release | Recommended SDK Version | Notes |
|---|---|---|
| Epoxy (2025.1) | >=4.1.0,<=4.22.0 |
Current default range; uv.lock pins 4.22.0. Unit tests pass with 4.1.0, 4.9.0 and 4.22.0 |
| 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 |
To change the SDK version for an older release, see OpenStack SDK version for older releases.
Documentation
| Guide | Contents |
|---|---|
| Usage guide | Example requests, bulk and filtered actions, post-action status, pagination |
| OpenWebUI guide | Docker Compose stack, direct MCP versus MCPO, OpenWebUI settings, troubleshooting |
| Claude Desktop guide | Extension bundle, uvx, source checkout, mcp-remote, remote connector |
| Claude Code guide | Registering the HTTP server in Claude Code |
| Configuration guide | Command-line options, environment variables, endpoints, HTTPS, multiple projects, SDK version |
| Security guide | Project isolation, read-only default, Bearer authentication |
| Multi-user guide | Per-user Application Credential authentication (experimental) |
| Development guide | Tests, live tool checks, adding tools, contributing |
| TODO | Outstanding implementation and live-validation work |
| OpenStack CLI vs MCP tools mapping | Every tool, its CLI equivalent, and its validation status |
| Validation evidence | Dates, revisions, conditions and counts of the live and unit-test checks |
📊 OpenStack CLI vs MCP Tools Mapping
✅ denotes an implemented API path, not certification of every action or OpenStack deployment. ⚠️ Live unverified identifies paths without successful live validation; ❌ Not implemented identifies unavailable capabilities. Service availability, permissions, and asynchronous completion affect results. See API prerequisites and result semantics and the multi-user setup guide.
Validation evidence: the live checks, Claude Code prompt checks and unit-test results behind the Status values below are recorded in docs/validation.md.
Detailed Mapping by Category
OpenStack Ops MCPのよくある質問
AIはOpenStackのリソースを変更または削除できますか?
変更ツールが有効になっている場合のみ可能です。デフォルトではサーバーは読み取り専用であり、作成、変更、または削除のツールは登録されていません。
このMCP serverはどのOpenStackサービスをカバーしていますか?
Nova、Neutron、Cinder、Glance、Keystone、Heat、Octavia、およびGnocchi/Aodhテレメトリをカバーする111個のツールを提供します。
複数のOpenStackプロジェクトにまたがって動作しますか?
いいえ、各サーバーインスタンスは単一のOpenStackプロジェクト内で動作し、リソースの所有権を確認します。複数のプロジェクトを管理するには、プロジェクトごとにサーバーを実行してください。
どのOpenStackリリースがサポートされていますか?
OpenStack Epoxy (2025.1)およびDalmatian (2024.2)に最適化されており、これらは完全にテスト済みです。その他の最新リリースも概ね互換性があります。
実行にはどのような認証情報が必要ですか?
サーバーがAPIにアクセスできるOpenStackアカウントのKeystoneホスト、プロジェクト、ユーザー名、およびパスワードが必要です。