OpenStack

v1.0.0Cloud Servicesstable

A lightweight and extensible service that enables AI assistants to securely execute OpenStack CLI commands via the Model Context Protocol (MCP)

openstackmcpai-integration
Share:
20
Stars
0
Downloads
0
Weekly
0/5

What is OpenStack?

OpenStack is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to lightweight and extensible service that enables ai assistants to securely execute openstack cli commands via the model context protocol (mcp)

A lightweight and extensible service that enables AI assistants to securely execute OpenStack CLI commands via the Model Context Protocol (MCP)

This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A lightweight and extensible service that enables AI assista

Use Cases

Execute OpenStack CLI commands securely through AI assistants. Manage cloud infrastructure operations programmatically with controlled access.
DragomirAlin

Maintainer

LicenseMIT
Languagejava
Versionv1.0.0
UpdatedMar 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx openstack

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use OpenStack

OpenStack MCP Server is a Spring Boot application that bridges AI assistants and OpenStack cloud infrastructure by securely executing OpenStack CLI commands on behalf of the AI via the Model Context Protocol. It authenticates to an OpenStack cloud using application credentials, exposes tools for listing servers, projects, images, and flavors, and is designed to be extended with additional OpenStack operations. DevOps engineers and cloud administrators use it to query and manage OpenStack resources through conversational AI without exposing raw API credentials to the AI assistant.

Prerequisites

  • Java 21 or later installed
  • Maven 3.8 or later installed
  • OpenStack CLI installed and functional in the environment where the server will run
  • OpenStack application credential ID and secret (preferred over username/password) from your OpenStack project
  • An MCP-compatible client such as Claude Desktop
1

Clone the repository and build the JAR

Clone the openstack-mcp-server repository and build it with Maven. This produces a self-contained JAR file in the target directory.

git clone https://github.com/DragomirAlin/openstack-mcp-server.git
cd openstack-mcp-server
mvn clean package
2

Configure OpenStack credentials in application.yml

Edit src/main/resources/application.yml to set your OpenStack authentication details. Using application credentials (applicationCredentialId and applicationCredentialSecret) is recommended over username/password as it allows scoping permissions.

openstack:
  authType: application_credential
  authUrl: https://identity.openstack.example.com:5000/v3
  identityApiVersion: 3
  regionName: RegionOne
  interface: public
  applicationCredentialId: your_app_credential_id
  applicationCredentialSecret: your_app_credential_secret
3

Run the server

Start the built JAR. By default the server binds to port 8080. Specify a different port if needed.

java -jar target/openstack-mcp-server-0.0.1.jar --port 8080 --host localhost
4

Configure Claude Desktop to connect to the server

Add the openstack-mcp-server to your Claude Desktop configuration, pointing to the JAR file you built. Update the path to match where the JAR was built on your system.

{
  "mcpServers": {
    "openstack-mcp-server": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/openstack-mcp-server/target/openstack-mcp-server-0.0.1.jar",
        "--port", "8080",
        "--host", "localhost"
      ]
    }
  }
}
5

Restart Claude Desktop and verify OpenStack connectivity

Quit and reopen Claude Desktop. Ask Claude to list your OpenStack servers or projects. If the server can reach the OpenStack identity endpoint and credentials are valid, it will return real resource data.

OpenStack Examples

Client configuration

Claude Desktop configuration launching the OpenStack MCP Server JAR directly.

{
  "mcpServers": {
    "openstack-mcp-server": {
      "command": "java",
      "args": [
        "-jar",
        "/home/user/openstack-mcp-server/target/openstack-mcp-server-0.0.1.jar",
        "--port", "8080",
        "--host", "localhost"
      ]
    }
  }
}

Prompts to try

Example prompts using the OpenStack MCP Server's infrastructure management tools.

- "List all my OpenStack servers and their current status"
- "What projects do I have access to in OpenStack?"
- "Show me all available images in the RegionOne region"
- "List all available flavors and their CPU/memory specifications"
- "How many running instances do I have across all projects?"

Troubleshooting OpenStack

Authentication fails with 401 Unauthorized from the OpenStack identity endpoint

Verify that openstack.authUrl points to the correct Keystone v3 endpoint for your cloud and that the applicationCredentialId and applicationCredentialSecret match an active application credential in your OpenStack project. Test the credentials directly with the OpenStack CLI: openstack server list.

mvn clean package fails with compilation errors

Ensure you are using Java 21 (not an older version). Run 'java -version' to check. The project uses Spring Boot 3.4.4 and Spring AI 1.0.0 which require Java 21. If multiple Java versions are installed, set JAVA_HOME to the Java 21 installation directory.

Claude Desktop shows the server as disconnected

Confirm the JAR path in your config is the absolute path to the built JAR in the target directory. Run the java -jar command manually in a terminal to see if the server starts and prints a startup log. Check that port 8080 is not blocked by a firewall or already in use.

Frequently Asked Questions about OpenStack

What is OpenStack?

OpenStack is a Model Context Protocol (MCP) server that lightweight and extensible service that enables ai assistants to securely execute openstack cli commands via the model context protocol (mcp) It connects AI assistants to external tools and data sources through a standardized interface.

How do I install OpenStack?

Follow the installation instructions on the OpenStack GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with OpenStack?

OpenStack works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is OpenStack free to use?

Yes, OpenStack is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Cloud Services MCP Servers

Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "openstack": { "command": "npx", "args": ["-y", "openstack"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use OpenStack?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides