Back to MCP directory
publicPublicdnsLocal runtime

openstack-mcp-server

一个轻量级可扩展服务,通过MCP协议让AI助手安全执行OpenStack CLI命令,支持与Claude桌面应用集成。

article

README

🚀 OpenStack MCP 服务器

这是一个轻量级且具备可扩展性的服务,它借助模型上下文协议(MCP),能让 AI 助手安全地执行 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 列出您的服务器或项目:

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

get-server get-flavors get-servers

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client