python-openstackmcp-server

python-openstackmcp-server

MCP server enabling AI-powered OpenStack cloud management

15
Stars
6
Forks
15
Watchers
11
Issues
python-openstackmcp-server implements the Model Context Protocol (MCP) to provide an interface for AI assistants to interact seamlessly with OpenStack cloud services. It supports the management of compute, image, identity, network, and block storage resources via the MCP standard, bridging the gap between AI clients and OpenStack APIs. The server connects to the OpenStack SDK and exposes capabilities such as authentication, configuration management, and resource operations for cloud environments.

Key Features

Full Model Context Protocol (MCP) support for AI assistants
OpenStack compute resource management
OpenStack image management tools
Integrated identity and authentication tools
OpenStack network resource management
OpenStack block storage management
Quick integration with Claude Desktop
Flexible configuration using clouds.yaml
Support for local and virtual environment workflows (uv, tox)
Comprehensive test coverage and CI tools

Use Cases

Automating OpenStack cloud operations via AI assistants
Integrating OpenStack management with popular AI clients like Claude Desktop
Managing cloud compute, image, and networking resources programmatically
Securely authenticating and handling multiple OpenStack environments
On-demand infrastructure provisioning and scaling
Facilitating cloud resource orchestration through standardized protocols
Boosting DevOps productivity with CLI and AI-driven workflows
Test automation and code linting for OpenStack-connected applications
Simplifying multi-cloud configuration and deployment
Enabling context-aware AI-based IT operations for cloud environments

README

python-openstackmcp-server

Openstack mcp server is a Model Context Protocol (MCP) server that provides an interface for AI assistants to interact with OpenStack services.

mermaid
flowchart LR
    AI[AI Assistant] <-->|MCP Protocol| Server[OpenStack MCP Server]
    Server <-->|OpenStack SDK| SDK[OpenStack SDK]
    SDK <-->|REST API| Cloud[OpenStack Cloud]

Table of Contents

Features

  • MCP Protocol Support: Implements the Model Context Protocol for AI assistants.
  • Compute Tools: Manage OpenStack compute resources (servers, flavors).
  • Image Tools: Manage OpenStack images.
  • Identity Tools: Handle OpenStack identity and authentication.
  • Network Tools: Manage OpenStack networking resources.
  • Block Storage Tools: Manage OpenStack block storage resources.

Quick Start with Claude Desktop

Get started quickly with the OpenStack MCP server using Claude Desktop

Requirements

  • Python 3.10 or higher
  • OpenStack credentials configured in clouds.yaml file
  • Claude Desktop installed
  1. Create or update your clouds.yaml file with your OpenStack credentials.

    Example clouds.yaml:

    yaml
    clouds:
      openstack:
        auth:
          auth_url: https://your-openstack-auth-url.com
          username: your-username
          password: your-password
          project_name: your-project-name
          user_domain_name: Default
          project_domain_name: Default
        region_name: your-region
        interface: public
        identity_api_version: 3
    
  2. Create or update your Claude Desktop configuration file:

    • macOS: Edit $HOME/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: Edit %APPDATA%\Claude\claude_desktop_config.json
    • Linux: Edit $HOME/.config/Claude/claude_desktop_config.json

Using python

json
{
  "mcpServers": {
    "openstack-mcp-server": {
      "command": "/path/to/your/python",
      "args": [
        "python-openstackmcp-server"
      ],
      "env" : {
        "OS_CLIENT_CONFIG_FILE": "/path/to/your/clouds.yaml"
      }
    }
  }
}

Using uvx

json
{
  "mcpServers": {
    "openstack-mcp-server": {
      "command": "uvx",
      "args": [
        "python-openstackmcp-server"
      ],
      "env" : {
        "OS_CLIENT_CONFIG_FILE": "/path/to/your/clouds.yaml"
      }
    }
  }
}

Development

Setup

This project supports both uv and tox for development and testing.

Using uv (Fast Local Development)

bash
# Install dependencies (including dev and test groups)
uv sync

# Run tests
uv run --group test pytest

# Run linting
uv run ruff check src tests

# Format code
uv run ruff format src tests

Using tox (OpenStack Standard)

bash
# Install tox
pip install tox
# or
uv tool install tox

# Run tests
tox -e py3

# Run linting
tox -e pep8

# Auto-format code
tox -e format

# Generate coverage report
tox -e cover

# Run arbitrary commands in virtualenv
tox -e venv -- <command>

# Test on specific Python version
tox -e py310  # or py311, py312, py313

# List all available environments
tox list

Testing

The project includes comprehensive test coverage (85%+). Tests are located in the tests/ directory.

bash
# Run all tests
tox -e py3

# Run with coverage
tox -e cover

# Run with debugger
tox -e debug

# Run specific test file
tox -e py3 -- tests/tools/test_compute_tools.py

Contributing

Contributions are welcome! Please see the CONTRIBUTING file for details on how to contribute to this project.

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.

Star History

Star History Chart

Repository Owner

openstack-kr
openstack-kr

Organization

Repository Details

Language Python
Default Branch develop
Size 279 KB
Contributors 8
License Apache License 2.0
MCP Verified Nov 11, 2025

Programming Languages

Python
100%

Topics

mcp-server openstack

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • OpenAI MCP Server

    OpenAI MCP Server

    Bridge between Claude and OpenAI models using the MCP protocol.

    OpenAI MCP Server enables direct querying of OpenAI language models from Claude via the Model Context Protocol (MCP). It provides a configurable Python server that exposes OpenAI APIs as MCP endpoints. The server is designed for seamless integration, requiring simple configuration updates and environment variable setup. Automated testing is supported to verify connectivity and response from the OpenAI API.

    • 77
    • MCP
    • pierrebrunelle/mcp-server-openai
  • CipherTrust Manager MCP Server

    CipherTrust Manager MCP Server

    Enables AI assistants to access CipherTrust Manager securely via the Model Context Protocol.

    CipherTrust Manager MCP Server provides an implementation of the Model Context Protocol (MCP), offering AI assistants such as Claude and Cursor a unified interface to interact with CipherTrust Manager resources. Communication is facilitated through JSON-RPC over stdin/stdout, enabling key management, CTE client management, user management, and connection management functionalities. The tool is configurable via environment variables and integrates with existing CipherTrust Manager instances using the ksctl CLI for secure resource access.

    • 7
    • MCP
    • sanyambassi/ciphertrust-manager-mcp-server
  • MCP Simple OpenAI Assistant

    MCP Simple OpenAI Assistant

    A simple MCP server for managing and interacting with OpenAI assistants.

    MCP Simple OpenAI Assistant enables seamless interaction with OpenAI assistants via the Model Context Protocol, providing tools to create, manage, and converse with AI assistants. It features real-time streaming responses, persistent thread management using a local database, and supports integration with client applications like Claude Desktop. The server handles assistant and conversation management, making it easy to create, list, update, and delete assistants and threads.

    • 36
    • MCP
    • andybrandt/mcp-simple-openai-assistant
  • books-mcp-server

    books-mcp-server

    A server implementation supporting Model Context Protocol integration with cherry-studio.

    books-mcp-server allows users to set up a Model Context Protocol (MCP) compliant server for managing and interacting with AI models. It enables integration with cherry-studio through STDIO commands and structured server configurations. The tool provides straightforward setup instructions and supports launching the server with customizable parameters, making it suitable for various AI context management tasks.

    • 5
    • MCP
    • VmLia/books-mcp-server
  • mcp-server-home-assistant

    mcp-server-home-assistant

    A Model Context Protocol Server integration for Home Assistant.

    Provides an MCP server interface for Home Assistant, enabling context sharing between Home Assistant and AI models through the Model Context Protocol. Allows users to connect Claude Desktop and similar tools to Home Assistant via a WebSocket API and secure API token. Facilitates seamless integration by leveraging a custom Home Assistant component that is migrating into Home Assistant Core. Enables access and manipulation of smart home context data in standardized ways.

    • 64
    • MCP
    • allenporter/mcp-server-home-assistant
  • Stape MCP Server

    Stape MCP Server

    An MCP server implementation for integrating Stape with AI model context protocols.

    Stape MCP Server provides an implementation of the Model Context Protocol server tailored for the Stape platform. It enables secure and standardized access to model context capabilities, allowing integration with tools such as Claude Desktop and Cursor AI. Users can easily configure and authenticate MCP connections using provided configuration samples, while managing context and credentials securely. The server is open source and maintained by the Stape Team under the Apache 2.0 license.

    • 4
    • MCP
    • stape-io/stape-mcp-server
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results