🚀 AWS 成本_notifier MCP 服务器
这是一个 MCP 服务器，主要用于获取 AWS 的月度成本，并展示服务详细信息。它会每日监控成本变动，还能自动以 GitHub 问题的形式创建变化报告。
✨ 主要特性
- 获取日度 AWS 成本总额。
- 提供服务级别的成本明细。
- 按类别汇总成本（如 EC2、安全、管理、存储等）。
- 进行前一日比较的变化分析。
- 以 JSON 格式输出成本信息。
- 自动向 GitHub 问题投稿报告。
📦 安装指南
克隆仓库
git clone https://github.com/yourusername/aws-cost-notifier-mcp-server.git
cd aws-cost-notifier-mcp-server
安装依赖项包
npm install
环境变量设置
- 将
.env.example复制为.env
cp .env.example .env
- 编辑
.env文件以配置必要的信息
# AWS 配置
AWS_PROFILE=default
AWS_REGION=ap-northeast-1
AWS_SDK_LOAD_CONFIG=1
# GitHub 配置
GITHUB_TOKEN=your_github_token_here
# 目标仓库
GITHUB_OWNER=your_organization_or_username
GITHUB_REPO=your_repository_name
TypeScript 构建
npm run build
💻 使用示例
直接执行
node build/index.js
作为 Cursor MCP 服务器运行
配置 .cursor/mcp.json
在 .cursor/mcp.json 中添加以下配置:
{
"mcpServers": {
"aws-cost-notifier": {
"command": "node",
"args": ["build/index.js"],
"cwd": "/path/to/aws-cost-notifier-mcp-server",
"env": {
"AWS_PROFILE": "default",
"AWS_REGION": "ap-northeast-1",
"AWS_SDK_LOAD_CONFIG": "1",
"GITHUB_TOKEN": "your_github_token",
"GITHUB_OWNER": "your_organization_or_username",
"GITHUB_REPO": "your_repository_name"
}
}
}
}
使用 Cursor 执行
mcp aws-cost-notifier
📚 详细文档
开发环境 - VSCode
此项目包含适用于 VSCode 的推荐设置：
推荐扩展
- ESLint
- Prettier
- TypeScript 和 JavaScript 语言功能
调试设置
- 使用 F5 键直接调试 TypeScript 代码。
- 环境变量从
.env文件自动读取。
自动格式化
- 在保存文件时自动格式化。
- 启用 ESLint 的自动修复。
输出形式
{
"summary": {
"period": {
"start": "2025-04-19",
"end": "2025-04-20"
},
"totalCost": "32.14",
"previousTotalCost": "31.98",
"changePercentage": "+0.5",
"currency": "USD"
},
"categories": [
{
"name": "ec2",
"current": "22.97",
"previous": "22.50",
"changePercentage": "+2.1",
"percentage": "71.5"
}
],
"details": [
{
"service": "Amazon Elastic Compute Cloud",
"current": "21.7158",
"previous": "21.2345",
"changePercentage": "+2.3",
"unit": "USD"
}
]
}
📄 注意事项
⚠️ 重要提示
- 成本为估算值，确切金额请在月底账单中确认。
- 使用 AWS Cost Explorer 可能会产生费用。
- 前一日比较显示日度变化，与月度趋势可能不同。
- 注意 GitHub 的 API 限制。