## 使用说明 ### 项目简介 cf-kaizen 项目包含 Cloud Foundry Butler 和 Hoover 的 MCP 服务器实现，旨在通过自然语言交互简化 Cloud Foundry 平台的运维和监控。这些服务器作为 Claude 桌面等 MCP 客户端的后端，提供了一系列工具，使用户可以通过自然语言指令获取 Cloud Foundry 平台的各种信息，例如应用使用情况、服务使用情况、平台指标、策略配置等。 ### 主要功能点 - **提供 Cloud Foundry Butler 工具集**: 集成 Cloud Foundry Butler API，提供丰富的 Cloud Foundry 运维和监控工具，例如： - 获取应用、服务和任务的使用报告。 - 查询策略配置信息。 - 获取 Ops Manager 产品和 stemcell 信息。 - 下载 Java 应用的 POM 文件。 - 获取 Cloud Foundry 平台快照信息，包括应用、服务实例、组织、空间、用户等详细信息和统计数据。 - **提供 Cloud Foundry Hoover 工具集**: 集成 Cloud Foundry Hoover API，提供 Cloud Foundry 平台监控和分析工具，例如： - 获取平台整体 демографика 信息。 - 获取应用、服务和任务的聚合使用报告。 - 查询快照详细信息和摘要信息。 - 获取组织和空间列表。 - 查询用户账户信息。 - **支持 Claude 桌面 MCP 客户端**: 提供详细的 MCP 客户端配置示例，方便用户快速将 MCP 服务器集成到 Claude 桌面，通过自然语言调用 Cloud Foundry 工具。 ### 安装步骤 1. **克隆仓库** 使用 Git CLI 或 Github CLI 克隆 cf-kaizen 仓库到本地： ```bash git clone https://github.com/cf-toolsuite/cf-kaizen ``` 或者 ```bash gh repo clone cf-toolsuite/cf-kaizen ``` 2. **构建项目** 进入 `cf-kaizen` 目录，使用 Maven 构建项目： ```bash cd cf-kaizen ./mvnw clean install ``` ### 服务器配置要将 MCP 服务器集成到 Claude 桌面，需要配置 `claude_desktop_config.json` 文件。以下是 Butler 和 Hoover 服务器的配置示例，选择你需要使用的服务器配置添加到该文件中。 **Butler MCP 服务器配置** ```json "cf-kaizen-butler-client": { "command": "java", "args": [ "-jar", "-Ddefault.url=", "/target/cf-kaizen-butler-server-0.0.1-SNAPSHOT.jar" ] } ``` **Hoover MCP 服务器配置** ```json "cf-kaizen-hoover-client": { "command": "java", "args": [ "-jar", "-Ddefault.url=", "/target/cf-kaizen-hoover-server-0.0.1-SNAPSHOT.jar" ] } ``` **参数说明:** - `server name`: `cf-kaizen-butler-client` 或 `cf-kaizen-hoover-client`，Claude 桌面中显示的工具集名称。 - `command`: `java`，运行 Java 程序的命令。 - `args`: 参数列表，包括： - `-jar`: 指定运行可执行 JAR 文件。 - `-Ddefault.url=` 或 `-Ddefault.url=`: 设置 `default.url` 系统属性，**请替换 `` 或 `` 为你的 cf-butler 或 cf-hoover 应用程序实例的 API Endpoint 地址**。 - `/target/cf-kaizen-butler-server-0.0.1-SNAPSHOT.jar` 或 `/target/cf-kaizen-hoover-server-0.0.1-SNAPSHOT.jar`: **请替换 `` 为你本地 cf-kaizen 项目的根目录的绝对路径**。指向构建后生成的 Butler 或 Hoover MCP 服务器 JAR 文件。 ### 基本使用方法 1. **配置 Claude 桌面**: 按照上述服务器配置说明，编辑 `claude_desktop_config.json` 文件，添加 Butler 或 Hoover MCP 服务器配置。 2. **启动 MCP 服务器**: 在 Claude 桌面启动时，会自动启动配置的 MCP 服务器。或者，你也可以在命令行手动运行服务器 JAR 文件。 3. **重启 Claude 桌面**: 重启 Claude 桌面使配置生效。 4. **在 Claude 桌面中使用工具**: 在 Claude 桌面的聊天界面，你可以使用自然语言指令，例如 "获取所有组织的列表" 或 "应用使用情况报告"，Claude 桌面会自动调用 MCP 服务器提供的工具来执行你的指令并返回结果。你可以在 Claude 桌面的工具列表中查看可用的工具。

"平台运维" 标签

Cloud Foundry Butler