OpenStack MCP Server

OpenStack MCP サーバー

概要

MCP（Model Context Protocol）を介して、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 の設定：OpenStack の認証情報を使用して、application.yml ファイルを更新します。
   • 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 ファイルを設定する必要があります。このファイルには、連携に必要な設定が含まれています。

<path_to_your_jar> を実際の 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 にサーバーまたはプロジェクトの一覧表示を依頼します。

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