OpenStack
A lightweight and extensible service that enables AI assistants to securely execute OpenStack CLI commands via the Model Context Protocol (MCP)
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
Maintainer
Works with
Installation
Manual Installation
npx openstackConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
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
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 packageConfigure 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_secretRun 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 localhostConfigure 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"
]
}
}
}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.
OpenStack Alternatives — Similar Cloud Services Servers
Looking for alternatives to OpenStack? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务,帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
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.
Set Up OpenStack in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
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.