Openstack MCP Server

🚀 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 列出您的服務器或項目：

• 列出我的服務器
• 列出我的項目
• 列出我的鏡像