使用说明

项目简介

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 工具。

安装步骤

克隆仓库 使用 Git CLI 或 Github CLI 克隆 cf-kaizen 仓库到本地：

git clone https://github.com/cf-toolsuite/cf-kaizen

或者

gh repo clone cf-toolsuite/cf-kaizen

构建项目 进入 'cf-kaizen' 目录，使用 Maven 构建项目：

cd cf-kaizen
./mvnw clean install

服务器配置

要将 MCP 服务器集成到 Claude 桌面，需要配置 'claude_desktop_config.json' 文件。以下是 Butler 和 Hoover 服务器的配置示例，选择你需要使用的服务器配置添加到该文件中。

Butler MCP 服务器配置

"cf-kaizen-butler-client": {
  "command": "java",
  "args": [
    "-jar",
    "-Ddefault.url=<cf-butler-application-instance-api-endpoint>",
    "<path-to-project>/target/cf-kaizen-butler-server-0.0.1-SNAPSHOT.jar"
  ]
}

Hoover MCP 服务器配置

"cf-kaizen-hoover-client": {
  "command": "java",
  "args": [
    "-jar",
    "-Ddefault.url=<cf-hoover-application-instance-api-endpoint>",
    "<path-to-project>/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=<cf-butler-application-instance-api-endpoint>' 或 '-Ddefault.url=<cf-hoover-application-instance-api-endpoint>': 设置 'default.url' 系统属性，请替换 '<cf-butler-application-instance-api-endpoint>' 或 '<cf-hoover-application-instance-api-endpoint>' 为你的 cf-butler 或 cf-hoover 应用程序实例的 API Endpoint 地址。
- '<path-to-project>/target/cf-kaizen-butler-server-0.0.1-SNAPSHOT.jar' 或 '<path-to-project>/target/cf-kaizen-hoover-server-0.0.1-SNAPSHOT.jar': 请替换 '<path-to-project>' 为你本地 cf-kaizen 项目的根目录的绝对路径。指向构建后生成的 Butler 或 Hoover MCP 服务器 JAR 文件。

基本使用方法

配置 Claude 桌面: 按照上述服务器配置说明，编辑 'claude_desktop_config.json' 文件，添加 Butler 或 Hoover MCP 服务器配置。
启动 MCP 服务器: 在 Claude 桌面启动时，会自动启动配置的 MCP 服务器。或者，你也可以在命令行手动运行服务器 JAR 文件。
重启 Claude 桌面: 重启 Claude 桌面使配置生效。
在 Claude 桌面中使用工具: 在 Claude 桌面的聊天界面，你可以使用自然语言指令，例如 "获取所有组织的列表" 或 "应用使用情况报告"，Claude 桌面会自动调用 MCP 服务器提供的工具来执行你的指令并返回结果。你可以在 Claude 桌面的工具列表中查看可用的工具。

关键词