概述

这是一项轻量级且可扩展的服务，使AI助手能够通过模型上下文协议（MCP）安全执行OpenStack的CLI命令。

该项目设计用于配合 Claude Desktop 应用程序，允许您直接从 AI 助手与 OpenStack 资源交互。

项目要求

• Java 21
• Maven 3.8+
• 弹簧靴 3.4.4
• 春季AI 1.0.0-M6
• 在您的机器上安装了OpenStack CLI

开始

先决条件

在开始之前，请确保你已安装以下设备：

• Java 21
• Maven 3.8+
• OpenStack CLI

配置

1. OpenStack配置：用你的OpenStack凭证更新application.yml文件。

• authUrl：您的OpenStack认证URL。
• regionName：你的 OpenStack 区域名称。
• applicationCredentialId：您的OpenStack应用凭证ID。
• applicationCredentialSecret：您的 OpenStack 应用凭证秘密。

包装

要将应用程序打包为 JAR 文件，请执行以下命令：

与 Claude Desktop 的集成

要将 OpenStack MCP 服务器与 Claude Desktop 集成，您需要配置 claude-desktop.json 文件。

OpenStack MCP Server

Overview

A lightweight and extensible service that enables AI assistants to securely execute OpenStack CLI commands via the Model Context Protocol (MCP).

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

Project Requirements

• Java 21
• Maven 3.8+
• Spring Boot 3.4.4
• Spring AI 1.0.0-M6
• OpenStack CLI installed on your machine

Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

• 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: 
  identityApiVersion: 3
  regionName: 
  interface: public
  applicationCredentialId: ""
  applicationCredentialSecret: ""

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 the integration.

Please update `` with the actual path to your JAR file.

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

Testing

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

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