Home / MCP / OpenStack MCP Server

OpenStack MCP Server

Provides an MCP-enabled bridge to securely run OpenStack CLI commands via an AI assistant.

other

16stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can securely execute OpenStack CLI commands through an MCP server, enabling AI assistants to interact with OpenStack resources safely and efficiently by sending commands via the Model Context Protocol (MCP).

How to use

Start by ensuring your environment has Java installed, the required prerequisites, and the OpenStack CLI configured. Run the MCP server locally and connect an MCP client to it to issue OpenStack commands through your AI assistant. A typical workflow is to start the server, configure the client to point to the running MCP endpoint, and then prompt your assistant to perform operations such as listing resources, creating instances, or managing images.

How to install

Prerequisites you need before installation:

- Java 21 installed on your machine

- Maven 3.8 or newer

- OpenStack CLI installed and configured on your machine

How to install

# Prerequisites (examples shown; adapt to your system)
# Ensure Java 21 is installed
java -version

docker --version

# Build the MCP server
mvn clean package

# Run the MCP server (example run)
jave -jar openstack-mcp-server-0.0.1.jar --port 8080 --host localhost

Configuration and usage notes

# OpenStack configuration in application.yml example snippet
spring:
  main:
    web-application-type: none
    banner-mode: off
  ai:
    mcp:
      server:
        name: openstack-mcp-server
        version: 0.0.1

logging:
  pattern:
    console:

openstack:
  authType: v3applicationcredential
  authUrl: <your_auth_url>
  identityApiVersion: 3
  regionName: <your_region_name>
  interface: public
  applicationCredentialId: "<your_application_credential_id>"
  applicationCredentialSecret: "<your_application_credential_secret>"

server:
  port: 8080

Claude Desktop integration example

{
  "mcpServers": {
    "openstack-mcp-server": {
      "command": "java",
      "args": [
        "-jar",
        "<path_to_your_jar>/openstack-mcp-server-0.0.1.jar",
        "--port",
        "8080",
        "--host",
        "localhost"
      ]
    }
  }
}

Testing the integration

Once the server is running and Claude Desktop is configured, you can test by asking the assistant to list your servers, projects, or images. Examples of prompts include: "List my servers", "List my projects", and "List my images".