python-openstackmcp-server 是一个 OpenStack MCP 服务器,全称为 OpenStack Model Context Protocol Server。它是一个基于 openstacksdk 的项目,通过实现 Model Context Protocol(MCP)协议,为 AI 助手提供与 OpenStack 服务进行交互的接口。
主要能力 该项目提供以下类型的工具能力:
计算工具(Compute Tools):管理 OpenStack 计算资源,包括服务器(servers)和规格(flavors)。 镜像工具(Image Tools):管理 OpenStack 镜像。 身份工具(Identity Tools):处理 OpenStack 身份认证相关操作。 网络工具(Network Tools):管理 OpenStack 网络资源。 块存储工具(Block Storage Tools):管理 OpenStack 块存储资源。
使用方式(基于 Claude Desktop 快速开始) 使用该服务器需要满足以下前提条件:
- Python 3.10 或更高版本。
- 在 clouds.yaml 文件中配置好 OpenStack 凭证。
- 安装 Claude Desktop。
配置步骤:
-
创建或更新 clouds.yaml 文件,填入 OpenStack 凭证。示例 clouds.yaml 内容如下: clouds: openstack: auth: auth_url: https://your-openstack-auth-url.com username: your-username password: your-password project_name: your-project-name user_domain_name: Default project_domain_name: Default region_name: your-region interface: public identity_api_version: 3
-
创建或更新 Claude Desktop 配置文件。不同系统的配置文件路径如下:
- macOS:编辑 $HOME/Library/Application Support/Claude/claude_desktop_config.json
- Windows:编辑 %APPDATA%\Claude\claude_desktop_config.json
- Linux:编辑 $HOME/.config/Claude/claude_desktop_config.json
开发与测试 该项目同时支持 uv 和 tox 两种方式进行开发与测试:
- 使用 uv(快速本地开发)。
- 使用 tox(OpenStack 标准方式)。
项目包含全面的测试覆盖,覆盖率在 85% 以上,测试文件位于 tests/ 目录中。
适用场景 该服务器适用于希望通过 AI 助手(如 Claude Desktop)对 OpenStack 云基础设施进行管理的场景,包括管理计算资源、镜像、身份认证、网络资源和块存储资源等操作。
限制与说明 目前资料中未提供具体的安装命令、价格、平台支持范围等更多细节。使用前需要具备可用的 OpenStack 环境与凭证。项目欢迎贡献,详情参见 CONTRIBUTING 文件。项目采用 Apache License 2.0 许可证,详情参见 LICENSE 文件。