Cloudability MCP Server MCP Server安装配置 GitHub与使用方法

选型结论

Cloudability MCP Server 属于运维云端类 MCP Server，公开资料标注 0 个工具，通过stdio 本地进程接入，适配 Claude，有可以直接复制的安装命令；接入前要先准备访问 Token。

分类

运维云端

传输方式

stdio

认证方式

访问 Token

部署方式

公开资料未说明

安装与配置

安装命令

uv run python run_server.py

公开命令不是通用的启动方式，拼不出可靠配置示例；请在客户端 MCP 配置里按官方文档填写 command 和 args。

上手步骤

1
准备运行环境
stdio 服务在本地起进程，需要先装好 Python，再按安装命令拉取依赖。
2
安装服务
复制下面的安装命令执行；命令里带占位符的位置换成自己的密钥或路径。
3
写入客户端配置
在客户端的 MCP 配置里填启动命令和参数，保存后完全退出客户端再打开，让新配置生效。
4
验证是否可用
连接成功后客户端会列出 0 个工具，随便调一个只读工具确认能返回结果。

接入前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

详细介绍

云能力MCP服务器

用于Cloudability API的全面模型上下文协议（MCP）服务器，提供高级成本管理、Kubernetes容器分析和预算预测功能。

🌟 为什么使用此MCP服务器？

🔥 集装箱优先：全面的Kubernetes成本分配和监控
📊 高级分析：15个维度，8个指标，灵活的过滤和分组
💰 预算管理：通过预测和警报完成预算生命周期
🚀 生产就绪：全面测试覆盖、类型安全和错误处理
🌍 多区域：支持美国、欧盟、亚太地区和中东地区的云计算能力
🔐 灵活的身份验证：现代Bearer令牌和传统基本身份验证

🚀 快速开始

先决条件

Python 3.12+ （现代类型注释需要）
紫外线 （推荐包管理器）
可云性API访问 （承载令牌或API密钥）

安装

# Clone the repository
git clone https://github.com/eelzinaty/cloudability-mcp-server.git
cd cloudability-mcp-server

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dependencies
uv sync

# Set up configuration
cp .env.example .env
# Edit .env with your Cloudability credentials

# Run the server
uv run python run_server.py

MCP客户端配置

添加到MCP客户端配置中：

{
  "mcpServers": {
    "cloudability": {
      "command": "uv",
      "args": ["run", "python", "main.py"],
      "cwd": "/path/to/cloudability-mcp-server",
      "env": {
        "CLOUDABILITY_API_URL": "https://api.cloudability.com/v3",
        "CLOUDABILITY_ENVIRONMENT_ID": "your-environment-id"
      }
    }
  }
}

特性

🚀 API全面覆盖

🔥 集装箱成本分配：完成Kubernetes成本分配和监控
🔥 容器配置：群集设置和度量代理部署
🔥 容器分析：使用模式、资源分配和效率分析
🔥 容器发现：标签、计数和资源库存管理
成本报告：灵活、强大的成本分析，包含15个维度和8个指标
异步报告：将长时间运行的报告排队进行后台处理
预算和预测：完成预算生命周期管理和支出预测
预算订阅：预算阈值的电子邮件通知
估计：本月支出预测及详细明细
预测：具有置信区间的多月预测分析
账单账户：访问计费帐户信息
传统端点：现有集成的向后兼容性

🔐 灵活的身份验证

承载令牌：现代apptio opentoken身份验证
基本认证：传统的API密钥身份验证
多区域支持：美国、欧盟、亚太地区和中小企业地区

📊 高级分析

丰富的过滤：按集群、命名空间、工作负载类型等进行筛选
灵活分组：按多个维度对结果进行分组
排序和分页：高效处理大型数据集
多种小部件类型：支持表格、KPI、图表和时间序列

🛠️ 开发者体验

FastMCP框架：现代MCP服务器实现
综合测试：具有模拟功能的完整测试覆盖率
类型安全：完整的类型注释，以获得更好的IDE支持
清洁建筑：独立的业务逻辑，便于维护

安装

此项目使用 uv 用于依赖性管理。确保你有 uv 安装。

# Install dependencies
uv sync

# Install development dependencies (for testing)
uv sync --dev

配置

创建一个 .env 文件基于 .env.example:

# Copy the example configuration
cp .env.example .env

环境变量

# Cloudability API Base URL (choose based on your region)
# US: https://api.cloudability.com/v3 (default)
# EU: https://api-eu.cloudability.com/v3
# APAC: https://api-au.cloudability.com/v3
# ME: https://api-me.cloudability.com/v3
CLOUDABILITY_API_URL=https://api.cloudability.com/v3

# Required for Bearer token authentication (apptio-opentoken)
# Get this from your Access Administration environment
CLOUDABILITY_ENVIRONMENT_ID=your-environment-id-here

# Optional: Default view ID for filtering
CLOUDABILITY_DEFAULT_VIEW_ID=0

身份验证方法

1.不记名代币（推荐）

对于使用apptio opentoken的现代Cloudability环境：

集 CLOUDABILITY_ENVIRONMENT_ID 在您的环境中
通过 authorization: "Bearer your-apptio-opentoken" 工具调用

2.基本身份验证（遗留）

对于传统的API密钥验证：

通过 authorization: "Basic your-api-key:" 工具调用
无需环境ID

用法

运行服务器

# Run the server directly
uv run python main.py

# Or use the run script
uv run python run_server.py

可用工具

🔥 集装箱成本分配工具

`provision_kubernetes_cluster`

设置新集群 用于通过自动化Metrics Agent部署进行云能力监控。

`get_cluster_deployment_yaml`

获取部署配置 用于在集群中安装Cloudability Metrics代理。

`analyze_container_cost_allocations`

主要集装箱成本分配工具 -Kubernetes成本分析最重要的工具。

主要特点：

共享资源分配：根据实际使用模式划分集群成本
公平份额计算：资源预留和实际消耗账户
未分配跟踪：识别闲置资源和优化机会
弹性分组：命名空间、服务、部署、pod、标签等。
资源指标：CPU、内存、网络、文件系统使用和保留

参数：

group：分组维度（例如，\[“命名空间”、“服务”、“cldy:labels:team”\]）
metrics：资源指标（例如，\[“cpu/reserved”，“memory/reserved_rss”\]）
filters：范围分析（例如，\[“cluster==uuid”，“namespace==product”\]）
cost_type：“调整成本”、“调整摊销成本”

退货：

采用公平份额计算的成本分配
资源使用指标和分配百分比
未分配的资源和优化见解
可用容量和加权系数

`get_container_resource_usage`

日常使用趋势 用于容量规划和规模调整分析。

`discover_container_labels`

查找可用的Kubernetes标签 用于自定义成本分配分组。

`count_container_resources`

资源调查 -统计集群中的命名空间、服务和Pod。

`get_detailed_cluster_info`

全面的集群元数据 具有节点详细信息和数据收集状态。

🚀 主要工具

`list_clusters`

获取所有Kubernetes集群 以及它们的UUID和元数据。

`list_budgets`

获取所有预算配置 具有当前状态和阈值。

`get_budget`

获取详细的预算信息 包括支出跟踪和警报。

`list_billing_accounts`

获取账单账户信息 跨云提供商。

📊 预算和预测工具

`get_spending_estimate`

本月支出预测 详细的服务明细和每日进度。

主要特点：

基于本月迄今使用情况的实时支出估算
服务级别支出驱动因素（AWS EC2、RDS等）
每日累计支出进展
与上月实际值比较
速率限制：10个请求/用户/分钟，20/org/分钟

`get_spending_forecast`

多月预测分析 具有置信区间和历史比较。

参数：

months_back （3-24）：建模的历史数据
months_forward （1-24）：预测期
use_current_estimate：在模型中包含当前月份
remove_credits：从分析中排除学分
remove_one_time_charges：过滤掉一次性成本

退货：

带上限/下限的月度预测
服务水平预测详细信息
用于比较的历史实际值
模型参数和置信度指标

`create_new_budget`

创建预算 具有每月阈值和成本基础配置。

`modify_budget`

更新现有预算 具有新的阈值或配置更改。

`remove_budget`

删除预算 从系统中永久删除。

`create_budget_alert`

设置电子邮件通知 违反预算门槛。

通知类型：

notify_exceeded：实际支出超过预算时发出警报
notify_expected：当预计支出超过预算时发出警报

`get_budget_alert` / `list_budget_alerts`

管理预算订阅 以及通知偏好。

`modify_budget_alert` / `remove_budget_alert`

更新或删除 预算通知订阅。

📊 成本报告工具

`execute_cost_report`

主要成本报告工具 具有高级分析和灵活的配置。

主要特点：

多达15个维度：供应商、地区、服务名称、资源标识符等。
多达8个指标：总成本、摊销成本、使用小时等。
高级过滤：12个运算符（==、！=、>、\100",

"region=@us-east" ], sort=["total_amortized_costDESC", "vendorASC"], limit=1000, authorization="Bearer your-token" )

Asynchronous reporting for large datasets

report_id = queue_cost_report( start_date="2024-01-01", end_date="2024-03-31", dimensions=["resource_identifier", "service_name", "region"], metrics=["total_amortized_cost", "usage_hours"], filters=["vendor==Amazon"], authorization="Bearer your-token" )

Check status and retrieve results

status = check_report_status( report_id=report_id["id"], authorization="Bearer your-token" )

if status["status"] == "finished": results = get_queued_report_results( report_id=report_id["id"], authorization="Bearer your-token" )

Discover available dimensions and metrics

measures = get_available_measures(authorization="Bearer your-token") operators = get_filter_operators(authorization="Bearer your-token")


## 发展

### 项目结构

cloudability-mcp-server/ ├── main.py # Main MCP server with tool definitions ├── cloudability_tools.py # Core API implementation ├── tests/ │ ├── test_cloudability.py # Legacy endpoint tests │ └── test_cloudability_tools.py # Comprehensive API tests ├── .env.example # Environment configuration template ├── pyproject.toml # Project configuration ├── run_server.py # Server runner script └── README.md # This documentation


### 建筑

- **main.py**：使用FastMCP装饰器清理MCP工具定义
- **cloudability_tools.py**：分离的业务逻辑，全面覆盖API
- **灵活的身份验证**：支持Bearer令牌和基本身份验证
- **综合测试**：HTTP模拟的完整测试覆盖率
- **类型安全**：完整的类型注释，以获得更好的开发体验

## 🤝 贡献

我们欢迎捐款！请查看我们的 [贡献指南](CONTRIBUTING.md) 了解详情。

### 快速贡献步骤

1. 分叉存储库
1. 创建要素分支： `git checkout -b feature/amazing-feature`
1. 通过测试进行更改
1. 运行质量检查： `uv run black . && uv run pytest`
1. 提交拉取请求

### 开发设置

Clone your fork

git clone https://github.com/eelzinaty/cloudability-mcp-server.git cd cloudability-mcp-server

Install development dependencies

uv sync --group dev

Run tests

uv run pytest tests/ -v

Format code

uv run black . && uv run isort .


## 📚 文档

- **[开发指南](DEVELOPMENT.md)**：综合发展文件
- **[贡献指南](CONTRIBUTING.md)**：如何为项目做出贡献
- **[API文档](tool.yaml)**：完整的工具架构定义
- **[可云性API文档](https://developers.cloudability.com/)**：API官方文件

## 🐛 问题与支持

- **错误报告**: 
- **功能请求**: 
- **讨论**: 

## 📄 许可证

此项目根据MIT许可证获得许可-请参阅 [许可证](LICENSE) 文件以获取详细信息。

## 🙏 致谢

- **[FastMCP](https://github.com/jlowin/fastmcp)**：现代MCP服务器框架
- **[模型上下文协议](https://modelcontextprotocol.io/)**：协议规范
- **云能力**：提供全面的云成本管理API

## 🔗 相关项目

- **[MCP服务器](https://github.com/modelcontextprotocol/servers)**：官方MCP服务器实施
- **[克劳德桌面](https://claude.ai/desktop)**：流行的MCP客户端
- **[其他MCP工具](https://github.com/topics/model-context-protocol)**：社区MCP实施

______________________________________________________________________

**由以下材料制成❤️ 面向FinOps和Kubernetes社区**

工具与能力

工具数量

0

资源数量

0

提示词数量

0

能力标签

云成本管理Python本地部署Kubernetes分析预算预测成本分配容器监控

支持客户端

Claude

数量来自来源目录的标注，具体工具清单以官方文档为准。

典型使用场景

看服务状态

查询容器、日志和监控指标，定位异常。

执行部署变更

在权限范围内触发发布、回滚和环境切换。

核对资源用量

汇总用量，找出闲置和超额的部分。

选择建议

值得选的地方

只提供 0 个工具，职责集中，接入后不容易误操作。
有现成的安装命令，不用自己找入口，照着跑就能起服务。
公开说明写得比较完整，接入前能看清能力边界。

先想清楚的地方

stdio 方式要求本地装好 Python，换机器要重新装一遍。
需要自备访问 Token，没有凭据没法直接试。
公开摘要偏短，具体能力和限制要回到仓库确认。

更适合

需要在运维云端场景里让模型直接调用外部能力的人。
已经在用 Claude 的用户，接入路径最短。
想先快速试一下、能接受在本地跑服务的人。

不太适合

完全不想在本地装环境的人。
暂时拿不到访问 Token的人。
需要厂商级 SLA 和技术支持的生产环境。

MCP Server	工具数	传输方式	安装命令	收录来源	最后核验
Cloudability MCP Server MCP World · 本页	0	stdio	有	1 个	2026-05-17
Ui Tars Desktop 8a825770 MCP World	0	stdio	有	1 个	2026-05-17
Elie222 MCP MCP World	0	未说明	未标注	1 个	2026-05-17
Arizeai Phoenix MCP MCP World	0	stdio	有	3 个	2026-05-17
Unity MCP 87ee506e MCP World	42	HTTP	有	2 个	2026-05-17

常见问题

5 条

Cloudability MCP Server 怎么安装？

公开资料给出的安装命令是 uv run python run_server.py，运行环境为 Python。装完后按客户端要求写进 MCP 配置，重启客户端生效。

Cloudability MCP Server 怎么在 Claude Desktop、Cursor 里配置？

它是stdio 本地进程，客户端配置里要写启动命令和参数，运行环境是 Python；保存后完全退出客户端再打开，配置才会生效。

Cloudability MCP Server 收费吗？

本站只整理公开资料，不代收费用，也没有标注具体价格。是否收费取决于服务本身和背后的接口额度，正式使用前按官方说明确认。

Cloudability MCP Server 需要 API Key 吗？

公开资料标注的认证方式是访问 Token，也就是要先拿到凭据才能连上；凭据只填在自己本地的配置里，不要写进公开仓库。

Cloudability MCP Server 支持哪些客户端？

公开资料标注支持 Claude；其他客户端只要能配置 MCP Server，也能用同样的命令或地址接入。

来源信息

MCP World

cloudability-mcp-server

一个全面的模型上下文协议（MCP）服务器，提供高级成本管理、Kubernetes容器分析和预算预测功能。

www.mcpworld.com

/detail/2374988e5cc0f36a0f3ac1e36bd230d1

参考链接

仓库入口

github.com

/eelzinaty/cloudability-mcp-server

来源标签

云成本管理Python本地部署Kubernetes分析预算预测成本分配容器监控

来源分类路径

云成本管理

继续浏览同类 MCP

更多运维云端 MCP（13,853）返回 MCP 目录

上一个 MCP

Cloud 349b0e64

全面解析Cloud Translation ApiMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器，Cloud Translation Api能让AI助手访问实时数据、执行操作，为您提供更智能的工作体验和自动化解决方案。

下一个 MCP

Cloud Abstraction Layer MCP Server

一个模型上下文协议（MCP）服务器，为Google Cloud Platform（GCP）和Microsoft Azure提供统一工具，使AI助手能够跨平台与云资源交互。

选型结论

安装与配置

详细介绍

云能力MCP服务器

🌟 为什么使用此MCP服务器？

🚀 快速开始

先决条件

安装

MCP客户端配置

特性

🚀 API全面覆盖

🔐 灵活的身份验证

📊 高级分析

🛠️ 开发者体验

安装

配置

环境变量

身份验证方法

1.不记名代币（推荐）

2.基本身份验证（遗留）

用法

运行服务器

可用工具

🔥 集装箱成本分配工具

provision_kubernetes_cluster

get_cluster_deployment_yaml

analyze_container_cost_allocations

get_container_resource_usage

discover_container_labels

count_container_resources

get_detailed_cluster_info

🚀 主要工具

list_clusters

list_budgets

get_budget

list_billing_accounts

📊 预算和预测工具

get_spending_estimate

get_spending_forecast

create_new_budget

modify_budget

remove_budget

create_budget_alert

get_budget_alert / list_budget_alerts

modify_budget_alert / remove_budget_alert

📊 成本报告工具

execute_cost_report

Asynchronous reporting for large datasets

Check status and retrieve results

Discover available dimensions and metrics

Clone your fork

Install development dependencies

Run tests

Format code

工具与能力

典型使用场景

选择建议

同类对比

常见问题

Cloudability MCP Server 怎么安装？

Cloudability MCP Server 怎么在 Claude Desktop、Cursor 里配置？

Cloudability MCP Server 收费吗？

Cloudability MCP Server 需要 API Key 吗？

Cloudability MCP Server 支持哪些客户端？

来源信息

继续浏览同类 MCP

`provision_kubernetes_cluster`

`get_cluster_deployment_yaml`

`analyze_container_cost_allocations`

`get_container_resource_usage`

`discover_container_labels`

`count_container_resources`

`get_detailed_cluster_info`

`list_clusters`

`list_budgets`

`get_budget`

`list_billing_accounts`

`get_spending_estimate`

`get_spending_forecast`

`create_new_budget`

`modify_budget`

`remove_budget`

`create_budget_alert`

`get_budget_alert` / `list_budget_alerts`

`modify_budget_alert` / `remove_budget_alert`

`execute_cost_report`