Openstack MCP Server

🚀 OpenStack MCP Server

A lightweight and scalable service that allows AI assistants to securely execute OpenStack CLI commands through the Model Context Protocol (MCP).

This project is designed to work with the Claude Desktop application, enabling you to interact with OpenStack resources directly from an AI assistant.

📦 Project Requirements

• Java 21
• Maven 3.8+
• Spring Boot 3.4.4
• Spring AI 1.0.0 - M6
• A computer with OpenStack CLI installed

🚀 Quick Start

Prerequisites

Before you start, make sure you have installed the following:

• Java 21
• Maven 3.8+
• OpenStack CLI

Configuration

1. OpenStack Configuration: Update the application.yml file with your OpenStack credentials.
   • authUrl: Your OpenStack authentication URL.
   • regionName: Your OpenStack region name.
   • applicationCredentialId: Your OpenStack application credential ID.
   • applicationCredentialSecret: Your OpenStack application credential secret.

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

Packaging

To package the application as a JAR file, run the following command:

mvn clean package

Integration with Claude Desktop

To integrate the OpenStack MCP server with Claude Desktop, you need to configure the claude-desktop.json file. This file contains the necessary configuration for integration.

Replace <path_to_your_jar> with the actual path to your JAR file.

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

Testing

To test the integration, prompt Claude Desktop to list your servers or projects:

• List my servers
• List my projects
• List my images