Openstack Commander

🚀 OpenStack MCP 服务器

OpenStack MCP 服务器是一个轻量级且可扩展的服务，它允许 AI 助手借助模型上下文协议 (MCP) 安全地执行 OpenStack CLI 命令。该项目主要与 Claude Desktop 应用程序搭配使用，让用户能直接通过 AI 助手访问 OpenStack 资源。

🚀 快速开始

项目要求

本项目运行需要以下环境和工具：

• Java 21
• Maven 3.8+
• Spring Boot 3.4.4
• Spring AI 1.0.0 - M6
• 已安装在机器上的 OpenStack CLI

入门步骤

先决条件

在开始之前，请确保您的机器已经安装了以下软件：

• Java 21
• Maven 3.8+
• OpenStack CLI

配置

1. OpenStack 配置：您需要更新 application.yml 文件中的 OpenStack 凭证。具体需要配置的参数如下：
   • authUrl：您的 OpenStack 身份验证 URL。
   • regionName：您的 OpenStack 区域名称。
   • applicationCredentialId：您的 OpenStack 应用凭证 ID。
   • applicationCredentialSecret：您的 OpenStack 应用凭证密钥。

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

打包

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

mvn clean package

集成与 Claude Desktop

若要将 OpenStack MCP 服务器集成到 Claude Desktop 中，需要对 claude-desktop.json 文件进行配置，该文件包含了集成所需的必要配置。请用实际的 JAR 文件路径替换 <path_to_your_jar>。

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

测试

若要测试集成效果，您可以向 Claude Desktop 发出以下指令来列出您的服务器或项目：

• 列出我的服务器
• 列出我的项目
• 列出我的镜像