OpenStack MCP + Agent PoC

Name: OpenStack MCP + Agent PoC
Author: Akrog

@Akrog

Repository

About OpenStack MCP + Agent PoC

An OpenStack MCP server PoC

#openstack #mcp #agent #poc

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-openstack": {
      "command": "uv",
      "args": [
        "run",
        "main.py",
        "--config",
        "../servers.yaml"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is OpenStack MCP + Agent PoC?

A proof-of-concept that runs an OpenStack Model Context Protocol (MCP) server alongside a basic agent companion program to test it. It uses the OpenStack code generator to create OpenAPI specs, then serves them with mcp-openapi as one MCP server per OpenStack component. The agent interacts with these servers via an LLM.

How to use OpenStack MCP + Agent PoC?

Clone the repository with submodules, edit servers.yaml to replace placeholder URLs for Nova, Cinder, and Glance, then run the server from the mcp-openapi directory with uv run main.py --config ../servers.yaml. In a second terminal, configure OpenStack client config (e.g., clouds.yaml) and LLM credentials in agent/agent.json, then run the agent with uv run main.py.

Key features of OpenStack MCP + Agent PoC

Generates OpenAPI specs from OpenStack using openstack-code-generator.
Serves specs as per‑component MCP servers via mcp-openapi.
Includes a minimal agent to query OpenStack resources through an LLM.
Filters REST API paths to limit tool count and context window.
Requires uv package manager, an OpenStack deployment, and an LLM.

Use cases of OpenStack MCP + Agent PoC

Quickly test OpenStack API interaction through an LLM.
Query OpenStack resources (e.g., flavors, servers) using natural language.
Experiment with MCP‑based tool use for OpenStack administration.

FAQ from OpenStack MCP + Agent PoC

What prerequisites are needed to run it?

You need access to an OpenStack deployment, an LLM endpoint, and the uv package manager.

How do I configure the OpenStack client?

Place clouds.yaml and secure.yaml in the agent/ directory or ~/.config/openstack/ as described in the OpenStack client documentation.

Where is the LLM token stored?

Create a file named llm.token in the agent/ directory containing the secret/token for the OpenAI LLM endpoint.

Can I use any OpenStack deployment?

Yes, you only need to replace the placeholder URLs in servers.yaml with your cluster’s Nova, Cinder, and Glance public endpoints.

Does the agent have memory?

No, each prompt is a clean prompt for the LLM—there is no memory between turns.

Comments

More AI & Agents MCP servers

1Panel

1Panel-dev

🔥 1Panel is a modern, open-source VPS control panel — and the only one with native AI agent support. Run Ollama models, deploy OpenClaw agents, and manage your entire server stack from one clean web interface.

36.1K

Unreal Engine Generative AI Support Plugin

prajwalshettydev

Unreal Engine plugin for LLM/GenAI models & MCP UE5 server. OpenAI GPT-5, Deepseek R1, Claude Opus/Sonnet, Gemini 3, Grok 4, Alibaba Qwen, Kimi, ElevenLabs TTS, Inworld, OpenRouter, Groq, GLM, Ollama, Local, Meshy, Tripo, Hunyuan3D, Rodin, fal, Dashscope, Seedream. NPC AI, agenti

622