mcp/cost-explorer-mcp-server详细的成本分析和报告。
什么是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 |
| ` |

manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务