OpenStack MCP sunucusu
Commit 3 Kas 2026Yapay zeka asistanlarının; hesaplama, imajlar, blok depolama, ağ ve Keystone kataloğu dahil olmak üzere OpenStack bulutlarını incelemesine olanak tanır.
Ayrıca bilinen adı oomchiller/openstack-mcp-server, openstack-mcp-server
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.1.2
- Son commit
- 3 Kas 2026
- Lisans
- Apache-2.0
OpenStack MCP nedir?
OpenStack bir MCP sunucusudur. Yapay zeka asistanlarının; hesaplama, imajlar, blok depolama, ağ ve Keystone kataloğu dahil olmak üzere OpenStack bulutlarını incelemesine olanak tanır.
Özet, projenin README dosyasından oluşturuldu
OpenStack MCP sunucusu hakkında
Bu sunucu, bulut yöneticileri ve geliştiriciler için OpenStack bulut ortamlarını bir yapay zeka asistanı aracılığıyla inceleme imkanı sağlar. Otuz iki özel okuma aracı kullanarak hesaplama, imajlar, blok depolama, ağ ve Keystone kataloğunu sorgulamak için yapılandırılmış bir yöntem sunar. Sunucu, stdio üzerinden yerel bir işlem olarak veya bir konteyner olarak çalışabilir; ayrıca bir loopback arayüzü üzerinde streamable HTTP için de yapılandırılabilir.
Kullanıcılar bağlantıyı standart OpenStack ortam değişkenlerini veya bir clouds.yaml dosyasını kullanarak yapılandırır. Güvenliği sağlamak amacıyla sunucu varsayılan olarak salt okunur olsa da, sunucular, birimler ve ağlar gibi kaynakları yönetmek için otuz bir deneysel yazma aracını etkinleştirmek üzere admin moduna geçirilebilir. Güvenlik, yapılandırılan kimliğin Keystone rolü üzerinden yönetilir; sunucu, bulut API'leri ile kontrollü etkileşimleri sürdürmek için proje izin listeleri ve yanıt boyutu sınırları gibi özellikler içerir.
Neler yapabilirsiniz
- 1Bulut kaynak envanterini denetlemeBelirli bir OpenStack projesi içindeki tüm mevcut hesaplama türlerini (flavors) ve ağ alt ağlarını listelemesi için bir yapay zekaya komut verin.
- 2Ağ yapılandırmalarını sorun gidermeAğ bağlantısını doğrulamak için tüm yönlendiricilerin, yüzen IP'lerin (floating IPs) ve güvenlik gruplarının bir özetini isteyin.
- 3Yapay zeka aracılığıyla bulut altyapısını yönetmeBir yapay zeka asistanının sunucuları ve birimleri oluşturmasına veya değiştirmesine olanak tanımak için yönetici yazma erişimini etkinleştirin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
OpenStack MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleOpenStack MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'OS_AUTH_URL=<OS_AUTH_URL>' --env 'OS_APPLICATION_CREDENTIAL_SECRET=<YOUR_OS_APPLICATION_CREDENTIAL_SECRET>' --env 'OS_PASSWORD=<YOUR_OS_PASSWORD>' openstack-mcp-server -- docker run -i --rm ghcr.io/oomchiller/openstack-mcp-server:0.1.2OpenStack MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"openstack-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/oomchiller/openstack-mcp-server:0.1.2"
],
"env": {
"OS_AUTH_URL": "<OS_AUTH_URL>",
"OS_APPLICATION_CREDENTIAL_SECRET": "<YOUR_OS_APPLICATION_CREDENTIAL_SECRET>",
"OS_PASSWORD": "<YOUR_OS_PASSWORD>"
}
}
}
}OpenStack MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"openstack-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/oomchiller/openstack-mcp-server:0.1.2"
],
"env": {
"OS_AUTH_URL": "<OS_AUTH_URL>",
"OS_APPLICATION_CREDENTIAL_SECRET": "<YOUR_OS_APPLICATION_CREDENTIAL_SECRET>",
"OS_PASSWORD": "<YOUR_OS_PASSWORD>"
}
}
}
}OpenStack MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"openstack-mcp-server","type":"stdio","command":"docker","args":["run","-i","--rm","ghcr.io/oomchiller/openstack-mcp-server:0.1.2"],"env":{"OS_AUTH_URL":"<OS_AUTH_URL>","OS_APPLICATION_CREDENTIAL_SECRET":"<YOUR_OS_APPLICATION_CREDENTIAL_SECRET>","OS_PASSWORD":"<YOUR_OS_PASSWORD>"}}'OpenStack MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"openstack-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/oomchiller/openstack-mcp-server:0.1.2"
],
"env": {
"OS_AUTH_URL": "<OS_AUTH_URL>",
"OS_APPLICATION_CREDENTIAL_SECRET": "<YOUR_OS_APPLICATION_CREDENTIAL_SECRET>",
"OS_PASSWORD": "<YOUR_OS_PASSWORD>"
}
}
}
}OpenStack MCP'yi Codex içine yükleyin
$ codex mcp add openstack-mcp-server --env 'OS_AUTH_URL=<OS_AUTH_URL>' --env 'OS_APPLICATION_CREDENTIAL_SECRET=<YOUR_OS_APPLICATION_CREDENTIAL_SECRET>' --env 'OS_PASSWORD=<YOUR_OS_PASSWORD>' -- docker run -i --rm ghcr.io/oomchiller/openstack-mcp-server:0.1.2OpenStack MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.openstack-mcp-server] command = "docker" args = ["run", "-i", "--rm", "ghcr.io/oomchiller/openstack-mcp-server:0.1.2"] [mcp_servers.openstack-mcp-server.env] OS_AUTH_URL = "<OS_AUTH_URL>" OS_APPLICATION_CREDENTIAL_SECRET = "<YOUR_OS_APPLICATION_CREDENTIAL_SECRET>" OS_PASSWORD = "<YOUR_OS_PASSWORD>"
OpenStack MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'OS_AUTH_URL=<OS_AUTH_URL>' -e 'OS_APPLICATION_CREDENTIAL_SECRET=<YOUR_OS_APPLICATION_CREDENTIAL_SECRET>' -e 'OS_PASSWORD=<YOUR_OS_PASSWORD>' openstack-mcp-server docker -- run -i --rm ghcr.io/oomchiller/openstack-mcp-server:0.1.2OpenStack MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"openstack-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/oomchiller/openstack-mcp-server:0.1.2"
],
"env": {
"OS_AUTH_URL": "<OS_AUTH_URL>",
"OS_APPLICATION_CREDENTIAL_SECRET": "<YOUR_OS_APPLICATION_CREDENTIAL_SECRET>",
"OS_PASSWORD": "<YOUR_OS_PASSWORD>"
}
}
}
}Yapılandırma
OS_AUTH_URLGerekliKeystone v3 endpoint, for example https://keystone.example.com:5000/v3
OS_APPLICATION_CREDENTIAL_SECRETGizliApplication credential secret
OS_PASSWORDGizliPassword for OS_USERNAME
OPENSTACK_MCP_CACERT_PEMCA bundle as PEM text, for a private CA
OPENSTACK_MCP_PROJECT_IDSComma-separated project IDs the server may use; the first is the default
OS_APPLICATION_CREDENTIAL_IDApplication credential ID, instead of a user name and password
OS_CLOUDOS_PROJECT_IDProject to scope the token to
OS_REGION_NAMERegion name
OS_USERNAMEUser name; omit when using an application credential
OS_USER_DOMAIN_NAMEDomain of OS_USERNAME
| Ad | Açıklama | Sunucu |
|---|---|---|
| OS_AUTH_URL | Keystone v3 endpoint, for example https://keystone.example.com:5000/v3 | Gerekli |
| OS_APPLICATION_CREDENTIAL_SECRET | Application credential secret | Gizli |
| OS_PASSWORD | Password for OS_USERNAME | Gizli |
| OPENSTACK_MCP_CACERT_PEM | CA bundle as PEM text, for a private CA | |
| OPENSTACK_MCP_PROJECT_IDS | Comma-separated project IDs the server may use; the first is the default | |
| OS_APPLICATION_CREDENTIAL_ID | Application credential ID, instead of a user name and password | |
| OS_CLOUD | — | |
| OS_PROJECT_ID | Project to scope the token to | |
| OS_REGION_NAME | Region name | |
| OS_USERNAME | User name; omit when using an application credential | |
| OS_USER_DOMAIN_NAME | Domain of OS_USERNAME |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebiliroomchiller/openstack-mcp-server is public and reachablegithub.com/oomchiller/openstack-mcp-server ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-03github.com/oomchiller/openstack-mcp-server ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
openstack-mcp-server
Community project, not affiliated with OpenStack/OpenInfra Foundation.
A Model Context Protocol server that lets AI assistants inspect OpenStack clouds. It is read-only by default, bounded in what it returns, and configured entirely through OpenStack's own settings and environment variables, so it runs unchanged as a local process or a container.
flowchart LR
AI[MCP client] <-->|stdio / Streamable HTTP| Server[openstack-mcp-server]
Server <-->|openstacksdk| Cloud[OpenStack APIs]
Features
- 32 read tools for compute, images, block storage, networking, the Keystone
catalog and service inventory, plus
get_scope. - Write tools are not registered unless explicitly enabled by two settings.
- Project allowlist: each allowed project gets its own project-scoped session.
- Every list has
limit,completeandnext_marker; results are typed (outputSchema,structuredContent) and capped in size. - Errors are
isErrorresults with a category and an action, without SDK messages, URLs or tokens. - stdio by default; Streamable HTTP on loopback as an option.
- Container image without credentials, running as an unprivileged user.
The read-only mode is a convenience. The security boundary is the Keystone role of the identity you configure; see SECURITY.md.
Quick start
The server is listed in the MCP Registry
as io.github.oomchiller/openstack-mcp-server; registry-aware clients can
install it from there. Manual setup:
Container (Docker MCP Toolkit or any MCP client)
docker run --rm -i \
-e OS_AUTH_URL=https://keystone.example.com:5000/v3 \
-e OS_USERNAME=mcp-reader -e OS_PASSWORD \
-e OS_USER_DOMAIN_NAME=Default -e OS_PROJECT_ID=0123456789abcdef0123456789abcdef \
-e OS_REGION_NAME=RegionOne \
ghcr.io/oomchiller/openstack-mcp-server@sha256:<digest>
Pin the image by digest; release digests are listed on the
releases page.
For a private CA, pass the certificate text in OPENSTACK_MCP_CACERT_PEM.
Local process with clouds.yaml
{
"mcpServers": {
"openstack": {
"command": "uvx",
"args": ["--from", "git+https://github.com/oomchiller/openstack-mcp-server@v0.1.2", "openstack-mcp-server"],
"env": { "OS_CLOUD": "mycloud" }
}
}
}
clouds.yaml is found the usual way (OS_CLIENT_CONFIG_FILE,
./clouds.yaml, ~/.config/openstack/clouds.yaml, /etc/openstack/).
Configuration
Credentials come from openstacksdk: OS_CLOUD with clouds.yaml, or OS_*
variables (password or application credentials). Server behaviour:
| Variable | Default | Meaning |
|---|---|---|
OPENSTACK_MCP_MODE |
readonly |
readonly or admin. |
OPENSTACK_MCP_ENABLE_WRITE_TOOLS |
false |
With admin, registers write tools. |
OPENSTACK_MCP_PROJECT_IDS |
empty | Comma-separated project IDs the server may use; the first is the default. |
OPENSTACK_MCP_DEFAULT_LIMIT |
50 |
Items per list call when limit is omitted. |
OPENSTACK_MCP_MAX_LIMIT |
100 |
Largest accepted limit (up to 1000). |
OPENSTACK_MCP_MAX_RESPONSE_BYTES |
524288 |
Largest result; larger ones fail with response_too_large. |
OPENSTACK_MCP_API_TIMEOUT |
10 |
Seconds per OpenStack request; no retries. |
OPENSTACK_MCP_CACERT_PEM |
unset | CA bundle as PEM text; takes precedence over OS_CACERT. |
OPENSTACK_MCP_ALLOW_INSECURE |
false |
Allow verify: false or an http:// auth URL. |
OPENSTACK_MCP_ENABLE_PROMPTS |
true |
Register the prompt. |
OPENSTACK_MCP_ENABLE_RESOURCES |
true |
Register openstack://scope. |
OPENSTACK_MCP_TRANSPORT |
stdio |
stdio or streamable-http. |
OPENSTACK_MCP_HTTP_HOST / _PORT |
127.0.0.1 / 8000 |
HTTP bind; path /mcp. |
OPENSTACK_MCP_HTTP_ALLOW_REMOTE |
false |
Allow a non-loopback HTTP bind. The HTTP transport has no authentication. |
OPENSTACK_MCP_LOG_LEVEL |
WARNING |
stderr log level. SDK loggers stay at CRITICAL. |
An invalid OPENSTACK_MCP_* value stops the server with exit code 2 and
names the variable. Missing credentials do not: the server starts, and cloud
tools return [not_configured].
Gateways that run several instances of this server and do not prefix prompt
names or resource URIs (Docker MCP Gateway) should set
OPENSTACK_MCP_ENABLE_PROMPTS=false and OPENSTACK_MCP_ENABLE_RESOURCES=false.
Tools
| Group | Tools |
|---|---|
| Scope | get_scope |
| Compute | list_servers, get_server, list_flavors |
| Image | list_images, get_image |
| Block storage | list_volumes, get_volume, list_volume_attachments, get_volume_attachment |
| Network | list_networks, get_network, list_subnets, get_subnet, list_ports, get_port, list_floating_ips, list_routers, get_router, list_router_interfaces, list_security_groups, get_security_group |
| Identity | list_regions, list_domains, list_projects, list_services, list_endpoints |
| Service inventory | list_hypervisors, list_compute_services, list_aggregates, list_network_agents, list_volume_services |
Identity and service inventory usually need more than a project reader
role; such calls fail with [forbidden] rather than returning empty lists.
With OPENSTACK_MCP_MODE=admin and OPENSTACK_MCP_ENABLE_WRITE_TOOLS=true,
31 experimental write tools are added (servers, volumes, images, networks,
subnets, ports, floating IPs, routers, security groups). See
docs/SPEC.md for the full behaviour.
Development
uv sync --locked
uv run pytest --cov
uv run ruff check . && uv run ruff format --check .
uv run mypy src tests
See CONTRIBUTING.md, ARCHITECTURE.md and DECISIONS.md.
License
Apache License 2.0; see LICENSE. Parts of the code started in openstack-kr/python-openstackmcp-server; see NOTICE.
OpenStack MCP soruları
OpenStack MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'OS_AUTH_URL=<OS_AUTH_URL>' --env 'OS_APPLICATION_CREDENTIAL_SECRET=<YOUR_OS_APPLICATION_CREDENTIAL_SECRET>' --env 'OS_PASSWORD=<YOUR_OS_PASSWORD>' openstack-mcp-server -- docker run -i --rm ghcr.io/oomchiller/openstack-mcp-server:0.1.2 komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
OpenStack MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Sunucu salt okunur mu?
Evet, varsayılan olarak salt okunurdur ancak belirli ayarlar değiştirilerek yazma araçları etkinleştirilebilir.
Bu sunucuyu bir konteyner içinde nasıl çalıştırabilirim?
OpenStack kimlik bilgilerini ortam değişkeni olarak aktararak Docker kullanarak çalıştırabilirsiniz.
Sunucu için güvenlik sınırı nedir?
Güvenlik sınırı, yapılandırdığınız kimliğin Keystone rolü ile belirlenir.
Yerel bir clouds.yaml dosyası kullanabilir miyim?
Evet, yapılandırma için bir clouds.yaml dosyası kullanarak sunucuyu yerel bir işlem olarak çalıştırabilirsiniz.