AWS Bedrock 日志 MCP

一个命令行界面和 API，用于通过 Anthropic 的 MCP（模型控制协议） 分析 AWS Bedrock 的使用情况和日志。

概述

此工具提供了一种便捷的方式，可以使用 Anthropic 的 Claude 模型作为交互界面来分析 AWS Bedrock 模型调用日志。它充当 MCP 服务器，向 Claude 公开 AWS CloudWatch Logs API 功能，允许您使用自然语言查询和分析 Bedrock 使用数据。

特性

• 模型使用情况分析：查看有关 Bedrock 模型使用情况和令牌消耗的详细统计信息
• 基于用户的分析：按用户分析使用模式和成本
• 每日使用情况报告：跟踪每日使用趋势和模型调用
• 令牌消耗指标：监控输入、完成和总令牌使用量
• 交互式界面：使用 Claude 通过自然语言查询您的 Bedrock 使用数据

要求

• Python 3.13+
• 具有 CloudWatch Logs 访问权限的 AWS 凭证
• Anthropic API 访问权限（用于 Claude 集成）

安装

1. 安装 uv：

   # 在 macOS 和 Linux 上
   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   # 在 Windows 上
   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

2. 克隆此存储库：

   git clone https://github.com/dheerajoruganty/aws-bedrock-logs-mcp-server.git
   cd aws-bedrock-logs-mcp-server
   

3. 设置 Python 虚拟环境并安装依赖项：

   uv venv && source .venv/bin/activate && uv pip sync pyproject.toml
   

   对于 Windows：

   uv venv && .venv\Scripts\activate && uv pip sync pyproject.toml
   

4. 配置您的 AWS 凭证：

   mkdir -p ~/.aws
   # 在 ~/.aws/credentials 和 ~/.aws/config 中设置您的凭证
   

用法

启动服务器

使用以下命令运行服务器：

python cloudwatch_mcp_server.py

默认情况下，服务器使用 stdio 传输与 MCP 客户端通信。

Claude Desktop 配置

使用 Claude Desktop 配置此工具：

{
  "mcpServers": {
    "aws_bedrock_logs": {
      "command": "uv",
      "args": [
          "--directory",
          "/path/to/aws-bedrock-logs-mcp",
          "run",
          "cloudwatch_mcp_server.py"
      ]
    }
  }
}

请确保将目录路径替换为您系统上存储库的实际路径。

可用工具

服务器公开了 Claude 可以使用的以下工具：

1. get_bedrock_logs_df：检索原始 Bedrock 调用日志作为 pandas DataFrame
2. get_model_usage_stats：获取按模型分组的使用情况统计信息
3. get_user_usage_stats：获取按用户分组的使用情况统计信息
4. get_daily_usage_stats：获取每日使用情况统计信息和趋势

示例查询

通过启用 MCP 的界面连接到 Claude 后，您可以提出如下问题：

• "显示过去 7 天的 Bedrock 使用情况统计信息"
• "按模型计算的平均令牌消耗量是多少？"
• "谁是 Bedrock 的总令牌数最多的用户？"
• "给我一个模型调用的每日细分"

开发

项目结构

• cloudwatch_mcp_server.py：带有 MCP 工具的主服务器实现
• pyproject.toml：项目依赖项和元数据
• Dockerfile：用于部署的容器定义

依赖项

主要依赖项包括：

• boto3：适用于 Python 的 AWS SDK
• mcp[cli]：Anthropic 的模型控制协议
• pandas：数据操作和分析
• pydantic：使用 Python 类型注释进行数据验证

许可证

MIT 许可证

致谢

• 此工具使用 Anthropic 的 MCP 框架
• 由 AWS CloudWatch Logs API 提供支持
• 使用 FastMCP 构建，用于服务器实现