详细的成本分析和报告。
什么是MCP Server?
| Attribute | 详情 |
|---|---|
| Docker镜像 | mcp/cost-explorer-mcp-server |
| 作者 | awslabs |
| 仓库 | [***] |
| Attribute | 详情 |
|---|---|
| Dockerfile | [***] |
| Docker镜像构建者 | Docker Inc. |
| Docker Scout健康评分 | !Docker Scout Health Score |
| 验证签名 | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/cost-explorer-mcp-server --key [***] |
| 许可证 | Apache License 2.0 |
| 此服务器提供的工具 | 简短描述 |
|---|---|
get_cost_and_usage | 检索AWS成本和使用数据。 |
get_cost_and_usage_comparisons | 比较两个时间段之间的AWS成本和使用情况。 |
get_cost_comparison_drivers | 分析两个时间段之间成本变化的驱动因素。 |
get_cost_forecast | 基于历史使用模式检索AWS成本预测。 |
get_dimension_values | 检索AWS Cost Explorer的可用维度值。 |
get_tag_values | 检索AWS Cost Explorer的可用标签值。 |
get_today_date | 检索UTC时区的当前日期信息。 |
get_cost_and_usage检索AWS成本和使用数据。
此工具检索指定账单周期内AWS服务的成本和使用数据,支持可选的过滤和分组。通过指定粒度、账单周期日期和过滤条件等参数,可以动态生成满足特定需求的成本报告。
注意:此工具中的end_date视为包含在内,即如果指定end_date为"2025-01-31",结果将包含1月31日的数据。这与AWS Cost Explorer API将end_date视为排除在外的处理方式不同。
重要:使用UsageQuantity指标时,AWS会聚合使用数量而不考虑单位。当不同使用类型具有不同单位时(例如,EC2计算小时与数据传输GB),结果将没有意义。要获得有意义的UsageQuantity结果,必须非常具体地进行过滤,包括USAGE_TYPE或USAGE_TYPE_GROUP。
示例:获取2025年5月us-east-1区域中EC2和S3服务的月度成本 await get_cost_and_usage( ctx=context, date_range={ "start_date": "2025-05-01", "end_date": "2025-05-31" }, granularity="MONTHLY", group_by={"Type": "DIMENSION", "Key": "SERVICE"}, filter_expression={ "And": [ { "Dimensions": { "Key": "SERVICE", "Values": ["Amazon Elastic Compute Cloud - Compute", "Amazon Simple Storage Service"], "MatchOptions": ["EQUALS"] } }, { "Dimensions": { "Key": "REGION", "Values": ["us-east-1"], "MatchOptions": ["EQUALS"] } } ] }, metric="UnblendedCost" )
示例:获取特定EC2实例使用的有意义UsageQuantity await get_cost_and_usage( ctx=context, { "date_range": { "start_date": "2025-05-01", "end_date": "2025-05-31" }, "filter_expression": { "And": [ { "Dimensions": { "Values": [ "Amazon Elastic Compute Cloud - Compute" ], "Key": "SERVICE", "MatchOptions": [ "EQUALS" ] } }, { "Dimensions": { "Values": [ "EC2: Running Hours" ], "Key": "USAGE_TYPE_GROUP", "MatchOptions": [ "EQUALS" ] } } ] }, "metric": "UsageQuantity", "group_by": "USAGE_TYPE", "granularity": "MONTHLY" }
| 参数 | 类型 | 描述 |
|---|---|---|
date_range | string | 账单周期的开始和结束日期,格式为YYYY-MM-DD(结束日期包含在内) |
filter_expression | string 可选 | 作为Python字典的过滤条件,用于缩小AWS成本范围。支持按维度(SERVICE、REGION等)、标签或成本类别过滤。可以使用逻辑运算符(And、Or、Not)进行复杂过滤。匹配选项验证:对于维度,有效值为['EQUALS', 'CASE_SENSITIVE']。对于标签和成本类别,有效值为['EQUALS', 'ABSENT', 'CASE_SENSITIVE'](默认为EQUALS和CASE_SENSITIVE)。示例:1)简单服务过滤:{'Dimensions': {'Key': 'SERVICE', 'Values': ['Amazon Elastic Compute Cloud - Compute', 'Amazon Simple Storage Service'], 'MatchOptions': ['EQUALS']}}。2)区域过滤:{'Dimensions': {'Key': 'REGION', 'Values': ['us-east-1'], 'MatchOptions': ['EQUALS']}}。3)组合过滤:{'And': [{'Dimensions': {'Key': 'SERVICE', 'Values': ['Amazon Elastic Compute Cloud - Compute'], 'MatchOptions': ['EQUALS']}}, {'Dimensions': {'Key': 'REGION', 'Values': ['us-east-1'], 'MatchOptions': ['EQUALS']}}]}。 |
granularity | string 可选 | 成本数据聚合的粒度。有效值为DAILY、MONTHLY、HOURLY。如果未提供,默认为MONTHLY。 |
group_by | string 可选 | 用于分组成本的字典(包含Type和Key),或简单的字符串键(默认DIMENSION类型)。示例字典:{'Type': 'DIMENSION', 'Key': 'SERVICE'}。示例字符串:'SERVICE'。 |
metric | string 可选 | 查询中返回的指标。有效值为AmortizedCost、BlendedCost、NetAmortizedCost、NetUnblendedCost、UnblendedCost、UsageQuantity。重要:对于UsageQuantity,服务聚合使用数量时不考虑单位,当混合不同单位类型时(例如,计算小时+数据传输GB),结果将没有意义。要获得有意义的UsageQuantity指标,必须按USAGE_TYPE或USAGE_TYPE_GROUP过滤或分组,以确保单位一致。 |
get_cost_and_usage_comparisons比较两个时间段之间的AWS成本和使用情况。
此工具比较基准期和比较期之间的成本和使用数据,提供百分比变化和绝对差异。两个周期必须恰好为一个月,且开始/结束日期为每月的第一天。该工具还在可用时提供详细的成本驱动因素,显示哪些特定因素导致了成本变化。
重要要求:
示例:比较2025年1月与2024年12月的EC2成本 await get_cost_and_usage_comparisons( ctx=context, baseline_date_range={ "start_date": "2024-12-01", # 2024年12月 "end_date": "2025-01-01" }, comparison_date_range={ "start_date": "2025-01-01", # 2025年1月 "end_date": "2025-02-01" }, metric_for_comparison="UnblendedCost", group_by={"Type": "DIMENSION", "Key": "SERVICE"}, filter_expression={ "Dimensions": { "Key": "SERVICE", "Values": ["Amazon Elastic Compute Cloud - Compute"], "MatchOptions": ["EQUALS"] } } )
| 参数 | 类型 | 描述 |
|---|---|---|
baseline_date_range | string | 用于比较的参考周期(恰好一个月) |
comparison_date_range | string | 比较周期(恰好一个月) |
filter_expression | string 可选 | 作为Python字典的过滤条件,用于缩小AWS成本比较范围。支持按维度(SERVICE、REGION等)、标签或成本类别过滤。可以使用逻辑运算符(And、Or、Not)进行复杂过滤。格式与get_cost_and_usage的filter_expression相同。 |
group_by | string 可选 | 用于分组比较的字典(包含Type和Key),或简单的字符串键(默认DIMENSION类型)。示例字典:{'Type': 'DIMENSION', 'Key': 'SERVICE'}。示例字符串:'SERVICE'。 |
metric_for_comparison | string 可选 | 用于比较的成本和使用指标。有效值为AmortizedCost、BlendedCost、NetAmortizedCost、NetUnblendedCost、UnblendedCost、UsageQuantity。 |
get_cost_comparison_drivers分析两个时间段之间成本变化的驱动因素。
此工具提供对导致周期之间变化的前10个最显著成本驱动因素的详细分析。AWS仅返回影响最大的驱动因素,以关注对成本优化最重要的变化。
该工具提供丰富的洞察,包括:
可带或不带过滤器使用:
两个周期必须恰好为一个月,且开始/结束日期为每月的第一天。
重要要求:
示例:分析所有服务的前10个成本驱动因素 await get_cost_comparison_drivers( ctx=context, baseline_date_range={ "start_date": "2024-12-01", # 2024年12月 "end_date": "2025-01-01" }, comparison_date_range={ "start_date": "2025-01-01", # 2025年1月 "end_date": "2025-02-01" }, metric_for_comparison="UnblendedCost", group_by={"Type": "DIMENSION", "Key": "SERVICE"} # 无过滤器 = 所有服务的前10个驱动因素 )
示例:分析特定服务的前10个成本驱动因素 await get_cost_comparison_drivers( ctx=context, baseline_date_range={ "start_date": "2024-12-01", "end_date": "2025-01-01" }, comparison_date_range={ "start_date": "2025-01-01", "end_date": "2025-02-01" }, metric_for_comparison="UnblendedCost", group_by={"Type": "DIMENSION", "Key": "SERVICE"}, filter_expression={ "Dimensions": { "Key": "SERVICE", "Values": ["Amazon Elastic Compute Cloud - Compute", "Amazon Simple Storage Service"], "MatchOptions": ["EQUALS"] } } )
| 参数 | 类型 | 描述 |
|---|---|---|
baseline_date_range | string | 用于比较的参考周期(恰好一个月) |
comparison_date_range | string | 比较周期(恰好一个月) |
filter_expression | string 可选 | 作为Python字典的过滤条件,用于缩小AWS成本驱动因素分析范围。支持按维度(SERVICE、REGION等)、标签或成本类别过滤。可以使用逻辑运算符(And、Or、Not)进行复杂过滤。格式与get_cost_and_usage的filter_expression相同。 |
group_by | string 可选 | 用于分组驱动因素分析的字典(包含Type和Key),或简单的字符串键(默认DIMENSION类型)。示例字典:{'Type': 'DIMENSION', 'Key': 'SERVICE'}。示例字符串:'SERVICE'。 |
metric_for_comparison | string 可选 | 用于分析驱动因素的成本和使用指标。有效值为AmortizedCost、BlendedCost、NetAmortizedCost、NetUnblendedCost、UnblendedCost、UsageQuantity。 |
get_cost_forecast基于历史使用模式检索AWS成本预测。
此工具使用AWS Cost Explorer的机器学***模型生成未来周期的成本预测。预测基于历史使用模式,可帮助进行预算规划和成本优化。
重要的粒度限制:
注意:预测开始日期必须等于或不晚于当前日期,而结束日期必须在未来。AWS自动使用可用的历史数据生成预测。预测返回总成本,不能按服务或区域等维度分组。
示例:获取下一季度EC2服务的月度成本预测 await get_cost_forecast( ctx=context, date_range={ "start_date": "2025-06-19", # 今天或更早 "end_date": "2025-09-30" # 未来日期 }, granularity="MONTHLY", filter_expression={ "Dimensions": { "Key": "SERVICE", "Values": ["Amazon Elastic Compute Cloud - Compute"], "MatchOptions": ["EQUALS"] } }, metric="UNBLENDED_COST", prediction_interval_level=80 )
| 参数 | 类型 | 描述 |
|---|---|---|
date_range | string | 预测周期日期,格式为YYYY-MM-DD(start_date <= 今天,end_date > 今天) |
filter_expression | string 可选 | 作为Python字典的过滤条件,用于缩小AWS成本预测范围。支持按维度(SERVICE、REGION等)、标签或成本类别过滤。可以使用逻辑运算符(And、Or、Not)进行复杂过滤。格式与get_cost_and_usage的filter_expression相同。 |
granularity | string 可选 | 预测数据聚合的粒度。有效值为DAILY和MONTHLY。每日预测支持最多3个月,每月预测支持最多12个月。如果未提供,默认为MONTHLY。 |
metric | string 可选 | 要预测的指标。有效值为AMORTIZED_COST、BLENDED_COST、NET_AMORTIZED_COST、NET_UNBLENDED_COST、UNBLENDED_COST。注意:AWS Cost Explorer不支持UsageQuantity预测。 |
prediction_interval_level | integer 可选 | 预测区间的置信水平。有效值为80和95。值越高,置信范围越宽。 |
get_dimension_values检索AWS Cost Explorer的可用维度值。
此工具检索指定维度(例如,SERVICE、REGION)在一段时间内的所有可用和有效值。这对于验证过滤值或探索成本分析的可用选项非常有用。
| 参数 | 类型 | 描述 |
|---|---|---|
date_range | string | 账单周期的开始和结束日期,格式为YYYY-MM-DD |
| ` |
来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像加速服务
在 Docker Desktop 配置镜像加速
Docker Compose 项目配置加速
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像加速
Synology 群晖 NAS 配置加速
飞牛 fnOS 系统配置镜像加速
极空间 NAS 系统配置加速服务
爱快 iKuai 路由系统配置加速
绿联 NAS 系统配置镜像加速
QNAP 威联通 NAS 配置加速
Podman 容器引擎配置加速
HPC 科学计算容器配置加速
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名加速
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429