使用说明

项目简介

本项目 'aws-cost-explorer-mcp-server' 是一个基于 Model Context Protocol (MCP) 的服务器实现,旨在通过自然语言处理 AWS 成本数据。它允许用户像与 AI 对话一样查询 AWS 支出,例如“昨天的 EC2 花费是多少?”或“按模型细分我的 Bedrock 使用量”。该服务器集成了 Amazon Bedrock 和 Claude 模型,以理解用户自然语言问题并提供详细的成本分析和洞察。

主要功能点

  • 自然语言查询: 使用自然语言提问,即可查询 AWS 各项服务的成本和使用情况。
  • 成本分析: 跟踪云服务成本,识别高成本资源,深入了解 Amazon Bedrock 模型的使用情况。
  • MCP 协议支持: 遵循 Model Context Protocol 标准,与 MCP 客户端进行通信。
  • AWS 服务集成: 利用 Amazon Bedrock 和 AWS Cost Explorer 等服务。

安装步骤

  1. 克隆仓库: 在本地克隆代码仓库:

    git clone https://github.com/aws-samples/aws-cost-explorer-mcp-server.git
  2. 进入项目目录:

    cd aws-cost-explorer-mcp-server
  3. 创建并激活虚拟环境 (可选): 建议创建虚拟环境以隔离项目依赖:

    python3 -m venv venv
    source venv/bin/activate  # 或根据你的系统使用 venv\Scripts\activate
  4. 安装依赖: 安装项目所需的 Python 库:

    pip install -r requirements.txt
  5. 配置 AWS 凭证: 确保已配置 AWS 访问密钥和区域。MCP 服务器需要能够访问 AWS Cost Explorer 和 Amazon Bedrock 服务的权限。您可以通过环境变量、AWS 配置文件或 IAM 角色等方式配置 AWS 凭证。

服务器配置

以下是 MCP 客户端连接 'aws-cost-explorer-mcp-server' 所需的服务器配置信息,请在 MCP 客户端中填入以下 JSON 配置:

{
  "server name": "aws-cost-explorer-mcp-server",
  "command": "python",
  "args": ["server.py", "--port", "8080"]
  // "command": 启动服务器的命令,这里使用 python 运行 server.py 脚本
  // "args":  启动命令的参数列表
  //   --port:  指定服务器监听的端口号,默认为 8080
}

基本使用方法

  1. 启动 MCP 服务器: 在项目目录下,运行以下命令启动 MCP 服务器:

    python server.py

    您可以使用 '--port' 参数指定服务器端口,例如 'python server.py --port 9000'。

  2. 配置 MCP 客户端: 在 MCP 客户端中,添加上述 服务器配置 信息,确保客户端能够连接到正在运行的 'aws-cost-explorer-mcp-server'。

  3. 使用 MCP 客户端查询: 使用 MCP 客户端发送 MCP 请求,例如查询资源 (Resources) 或调用工具 (Tools),以自然语言方式探索和分析 AWS 成本数据。具体查询方式和支持的自然语言指令,请参考 MCP 客户端的文档和本项目的 'README.md' 文件。

信息

分类

商业系统