Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Description from the maker (original English)
Read-only-first OpenStack inspection: servers, images, volumes, networks, Keystone catalog.
These three are never merged into one score: opinions, measurements and popularity are different things.
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
OS_AUTH_URL, OS_USERNAME, OS_PASSWORD, OS_USER_DOMAIN_NAME, OS_PROJECT_ID, OS_APPLICATION_CREDENTIAL_ID, OS_APPLICATION_CREDENTIAL_SECRET, OS_REGION_NAME, OPENSTACK_MCP_PROJECT_IDS, OPENSTACK_MCP_CACERT_PEMValues marked secret are keys to your account. Never share them or paste them into a chat.
You need
Which app do you use?
Pick your app above. We remember it, so next time the button says “Install in …”.
Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json
{
"mcpServers": {
"openstack": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"OS_AUTH_URL",
"-e",
"OS_USERNAME",
"-e",
"OS_PASSWORD",
"-e",
"OS_USER_DOMAIN_NAME",
"-e",
"OS_PROJECT_ID",
"-e",
"OS_APPLICATION_CREDENTIAL_ID",
"-e",
"OS_APPLICATION_CREDENTIAL_SECRET",
"-e",
"OS_REGION_NAME",
"-e",
"OPENSTACK_MCP_PROJECT_IDS",
"-e",
"OPENSTACK_MCP_CACERT_PEM",
"ghcr.io/oomchiller/openstack-mcp-server:0.1.2"
],
"env": {
"OS_AUTH_URL": "your-value",
"OS_USERNAME": "your-value",
"OS_PASSWORD": "your-value",
"OS_USER_DOMAIN_NAME": "your-value",
"OS_PROJECT_ID": "your-value",
"OS_APPLICATION_CREDENTIAL_ID": "your-value",
"OS_APPLICATION_CREDENTIAL_SECRET": "your-value",
"OS_REGION_NAME": "your-value",
"OPENSTACK_MCP_PROJECT_IDS": "your-value",
"OPENSTACK_MCP_CACERT_PEM": "your-value"
}
}
}
}Run this in your terminal
claude mcp add openstack --env OS_AUTH_URL=your-value --env OS_USERNAME=your-value --env OS_PASSWORD=your-value --env OS_USER_DOMAIN_NAME=your-value --env OS_PROJECT_ID=your-value --env OS_APPLICATION_CREDENTIAL_ID=your-value --env OS_APPLICATION_CREDENTIAL_SECRET=your-value --env OS_REGION_NAME=your-value --env OPENSTACK_MCP_PROJECT_IDS=your-value --env OPENSTACK_MCP_CACERT_PEM=your-value -- docker run -i --rm -e OS_AUTH_URL -e OS_USERNAME -e OS_PASSWORD -e OS_USER_DOMAIN_NAME -e OS_PROJECT_ID -e OS_APPLICATION_CREDENTIAL_ID -e OS_APPLICATION_CREDENTIAL_SECRET -e OS_REGION_NAME -e OPENSTACK_MCP_PROJECT_IDS -e OPENSTACK_MCP_CACERT_PEM ghcr.io/oomchiller/openstack-mcp-server:0.1.2Fill in the empty values before running it.
Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"openstack": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"OS_AUTH_URL",
"-e",
"OS_USERNAME",
"-e",
"OS_PASSWORD",
"-e",
"OS_USER_DOMAIN_NAME",
"-e",
"OS_PROJECT_ID",
"-e",
"OS_APPLICATION_CREDENTIAL_ID",
"-e",
"OS_APPLICATION_CREDENTIAL_SECRET",
"-e",
"OS_REGION_NAME",
"-e",
"OPENSTACK_MCP_PROJECT_IDS",
"-e",
"OPENSTACK_MCP_CACERT_PEM",
"ghcr.io/oomchiller/openstack-mcp-server:0.1.2"
],
"env": {
"OS_AUTH_URL": "your-value",
"OS_USERNAME": "your-value",
"OS_PASSWORD": "your-value",
"OS_USER_DOMAIN_NAME": "your-value",
"OS_PROJECT_ID": "your-value",
"OS_APPLICATION_CREDENTIAL_ID": "your-value",
"OS_APPLICATION_CREDENTIAL_SECRET": "your-value",
"OS_REGION_NAME": "your-value",
"OPENSTACK_MCP_PROJECT_IDS": "your-value",
"OPENSTACK_MCP_CACERT_PEM": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
Paste into .vscode/mcp.json in your project
{
"servers": {
"openstack": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"OS_AUTH_URL",
"-e",
"OS_USERNAME",
"-e",
"OS_PASSWORD",
"-e",
"OS_USER_DOMAIN_NAME",
"-e",
"OS_PROJECT_ID",
"-e",
"OS_APPLICATION_CREDENTIAL_ID",
"-e",
"OS_APPLICATION_CREDENTIAL_SECRET",
"-e",
"OS_REGION_NAME",
"-e",
"OPENSTACK_MCP_PROJECT_IDS",
"-e",
"OPENSTACK_MCP_CACERT_PEM",
"ghcr.io/oomchiller/openstack-mcp-server:0.1.2"
],
"env": {
"OS_AUTH_URL": "your-value",
"OS_USERNAME": "your-value",
"OS_PASSWORD": "your-value",
"OS_USER_DOMAIN_NAME": "your-value",
"OS_PROJECT_ID": "your-value",
"OS_APPLICATION_CREDENTIAL_ID": "your-value",
"OS_APPLICATION_CREDENTIAL_SECRET": "your-value",
"OS_REGION_NAME": "your-value",
"OPENSTACK_MCP_PROJECT_IDS": "your-value",
"OPENSTACK_MCP_CACERT_PEM": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.
Your choice stays on this device in a cookie; no account needed.
OS_USERNAME envOS_USER_DOMAIN_NAME envOS_PROJECT_ID envOS_APPLICATION_CREDENTIAL_ID envOS_REGION_NAME envOPENSTACK_MCP_PROJECT_IDS envOPENSTACK_MCP_CACERT_PEM envThese settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026
The registry name was verified with the GitHub account oomchiller, which owns the repo
We have not read this repo from GitHub yet
We have not read this repo from GitHub yet
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: OS_AUTH_URL, OS_PASSWORD, OS_APPLICATION_CREDENTIAL_SECRET
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed –, and the latest version (0.1.2) reached the registry 3 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Docker on your computer.
In the same category: Spec Driven Development, Remote Desktop Commander, topo^alpin
Servers in the same category from other makers, sorted by stars.
Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Avalanche bulletins and mountain weather forecasts for any place in the Alps.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
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]
get_scope.limit, complete and next_marker; results are typed (outputSchema, structuredContent) and capped in size.isError results with a category and an action, without SDK messages, URLs or tokens.The read-only mode is a convenience. The security boundary is the Keystone role of the identity you configure; see SECURITY.md.
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:
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:
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.
{
"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/).
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.
| 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.
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.
Apache License 2.0; see LICENSE. Parts of the code started in openstack-kr/python-openstackmcp-server; see NOTICE.