MCP server OpenStack
Коммит 3 нояб. 2026 г.Позволяет ИИ-ассистентам проводить аудит облаков OpenStack, включая вычисления, образы, блочное хранилище, сети и каталог Keystone.
Также известен как oomchiller/openstack-mcp-server, openstack-mcp-server
- Звёзды
- 0
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- 0.1.2
- Последний коммит
- 3 нояб. 2026 г.
- Лицензия
- Apache-2.0
Что такое OpenStack MCP?
Позволяет ИИ-ассистентам проводить аудит облаков OpenStack, включая вычисления, образы, блочное хранилище, сети и каталог Keystone.
Сводка сгенерирована из README проекта
О OpenStack MCP server
Этот сервер позволяет облачным администраторам и разработчикам проводить аудит сред OpenStack с помощью ИИ-ассистентов. Он предоставляет структурированный способ запроса данных о вычислениях, образах, блочном хранилище, сетях и каталоге Keystone, используя тридцать два специализированных инструмента для чтения. Сервер работает как локальный процесс через stdio или как контейнер, а также может быть настроен для работы через streamable HTTP на loopback-интерфейсе.
Пользователи настраивают подключение с помощью стандартных переменных окружения OpenStack или файла clouds.yaml. Хотя по умолчанию сервер работает в режиме только для чтения для обеспечения безопасности, его можно переключить в режим администратора, чтобы активировать тридцать один экспериментальный инструмент записи для управления такими ресурсами, как серверы, тома и сети. Безопасность управляется через роль Keystone настроенной учетной записи; сервер также включает такие функции, как белые списки проектов и ограничения размера ответов для контроля взаимодействия с API облака.
Что вы можете с ним делать
- 1Аудит инвентаризации облачных ресурсовПопросите ИИ составить список всех доступных типов вычислительных ресурсов (flavors) и сетевых подсетей в рамках конкретного проекта OpenStack.
- 2Устранение неполадок в конфигурации сетиЗапросите сводную информацию обо всех маршрутизаторах, плавающих IP-адресах (floating IPs) и группах безопасности для проверки сетевого соединения.
- 3Управление облачной инфраструктурой через ИИВключите административный доступ на запись, чтобы позволить ИИ-ассистенту создавать или изменять серверы и тома.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить OpenStack MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка OpenStack MCP в Claude Code
$ 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Установка OpenStack MCP в Cursor
~/.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 в VS Code
.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 в VS Code CLI
$ 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 в Claude Desktop
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 в Codex
$ 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.2Установка OpenStack MCP в Codex config.toml
~/.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 в Gemini CLI
$ 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.2Установка OpenStack MCP в Gemini settings.json
~/.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>"
}
}
}
}Конфигурация
OS_AUTH_URLОбязательноKeystone v3 endpoint, for example https://keystone.example.com:5000/v3
OS_APPLICATION_CREDENTIAL_SECRETСекретApplication credential secret
OS_PASSWORDСекретPassword 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
| Название | Описание | Тип |
|---|---|---|
| OS_AUTH_URL | Keystone v3 endpoint, for example https://keystone.example.com:5000/v3 | Обязательно |
| OS_APPLICATION_CREDENTIAL_SECRET | Application credential secret | Секрет |
| OS_PASSWORD | Password for OS_USERNAME | Секрет |
| 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 |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийoomchiller/openstack-mcp-server is public and reachablegithub.com/oomchiller/openstack-mcp-server ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-11-03github.com/oomchiller/openstack-mcp-server ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на GitHubopenstack-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
Как добавить OpenStack MCP в Claude Code?
Выполните 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 в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить OpenStack MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Является ли сервер доступным только для чтения?
Да, по умолчанию он работает в режиме только для чтения, но инструменты записи можно включить, изменив определенные настройки.
Как запустить этот сервер в контейнере?
Вы можете запустить его через Docker, передав учетные данные OpenStack в качестве переменных окружения.
Каковы границы безопасности сервера?
Границы безопасности определяются ролью Keystone той учетной записи, которую вы настраиваете.
Могу ли я использовать локальный файл clouds.yaml?
Да, вы можете запустить сервер как локальный процесс, используя файл clouds.yaml для конфигурации.