项目简介
OpenStack MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,它允许 AI 助手(如 Claude Desktop)通过执行 OpenStack 命令行工具 (CLI) 来管理和操作 OpenStack 云平台上的资源。该服务器充当 AI 助手与 OpenStack 基础设施之间的桥梁,提供安全的访问控制和命令执行能力。
主要功能点
- 执行 OpenStack CLI 命令: 允许 AI 助手通过预定义的工具安全地执行 OpenStack CLI 命令。
- 集成 Claude Desktop: 专门设计用于与 Claude Desktop 等 AI 助手应用集成。
- 资源管理: 通过 OpenStack CLI 间接管理 OpenStack 云资源,例如服务器、项目、镜像等。
安装步骤
- 安装 Java 21 和 Maven 3.8+: 确保你的系统已安装 Java 21 或更高版本,以及 Maven 3.8 或更高版本。
- 安装 OpenStack CLI: 确保你的系统已安装 OpenStack 命令行工具,并已配置可以连接到你的 OpenStack 环境。
- 配置 OpenStack 凭据: 编辑 'application.yml' 文件,配置你的 OpenStack 认证信息,包括 'authUrl', 'regionName', 'applicationCredentialId', 和 'applicationCredentialSecret'。
- 打包应用: 在项目根目录下运行 'mvn clean package' 命令,将应用打包成 JAR 文件。
服务器配置
要将 OpenStack MCP 服务器集成到 MCP 客户端(例如 Claude Desktop),需要在客户端的配置文件中添加服务器配置信息。以下是一个 'claude-desktop.json' 示例配置,用于配置名为 "openstack-mcp-server" 的 MCP 服务器:
{ "mcpServers": { "openstack-mcp-server": { "command": "java", "args": [ "-jar", "/path/to/your/jar/openstack-mcp-server-0.0.1.jar", // 请替换为你的 JAR 文件路径 "--port", "8080", "--host", "localhost" ] } } }
配置参数说明:
- 'command': 启动 MCP 服务器的命令,这里使用 'java' 命令。
- 'args': 传递给 'java' 命令的参数列表,包括:
- '-jar /path/to/your/jar/openstack-mcp-server-0.0.1.jar': 指定要运行的 JAR 文件路径。请务必替换 '/path/to/your/jar/openstack-mcp-server-0.0.1.jar' 为实际的 JAR 文件路径。
- '--port 8080': 指定服务器监听的端口为 8080。
- '--host localhost': 指定服务器绑定的主机地址为 localhost。
基本使用方法
- 启动 OpenStack MCP 服务器。
- 配置 MCP 客户端(如 Claude Desktop)连接到 OpenStack MCP 服务器。
- 在 MCP 客户端中,可以使用自然语言指令指示 AI 助手与 OpenStack 交互,例如:
- 'List my servers' (列出我的服务器)
- 'List my projects' (列出我的项目)
- 'List my images' (列出我的镜像) AI 助手将调用 OpenStack MCP 服务器上的工具来执行相应的 OpenStack CLI 命令,并将结果返回给你。
信息
分类
开发者工具