AWS Bedrock Logs MCP

AWS Bedrock Logs MCP

site icon
2025.03.11 0
PythonAWS Bedrock 日志分析自然语言查询模型使用监控开发效率数据库
AWS Bedrock Logs MCP 是一个命令行界面和 API 工具,用于通过 Anthropic 的 MCP(模型控制协议)分析 AWS Bedrock 的使用情况和日志。该工具提供了一个便捷的方式来分析 AWS Bedrock 模型调用日志,使用 Anthropic 的 Claude 模型作为交互式接口。它作为一个 MCP 服务器,将 AWS CloudWatch Logs API 功能暴露给 Claude,允许用户通过自然语言查询和分析 Bedrock 使用数据。
View on GitHub

Overview

基本能力

产品定位

AWS Bedrock Logs MCP 是一个用于分析和监控 AWS Bedrock 模型使用情况的工具,通过与 Claude 模型的交互,提供自然语言查询和分析功能。

核心功能

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

适用场景

  • 监控 AWS Bedrock 模型的使用情况和成本
  • 分析用户使用模式,优化资源分配
  • 生成每日或定期的使用报告
  • 通过自然语言查询快速获取使用数据

工具列表

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

常见问题解答

  • Q: 如何配置 AWS 凭证? A: 需要在 ~/.aws/credentials~/.aws/config 中设置 AWS 凭证。
  • Q: 如何启动服务器? A: 运行 python cloudwatch_mcp_server.py 命令启动服务器。

使用教程

使用依赖

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

安装教程

  1. 安装 uvbash # On macOS and Linux curl -LsSf https://astral.sh/uv/install.sh | sh

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

  1. 克隆仓库: git clone https://github.com/dheerajoruganty/aws-bedrock-logs-mcp-server.git cd aws-bedrock-logs-mcp-server

  2. 设置 Python 虚拟环境并安装依赖: uv venv && source .venv/bin/activate && uv pip sync pyproject.toml

Windows 用户: uv venv && .venv\Scripts\activate && uv pip sync pyproject.toml

  1. 配置 AWS 凭证: mkdir -p ~/.aws # 在 ~/.aws/credentials 和 ~/.aws/config 中设置凭证

调试方式

  1. 启动服务器: python cloudwatch_mcp_server.py

  2. 配置 Claude Desktop: json { "mcpServers": { "aws_bedrock_logs": { "command": "uv", "args": [ "--directory", "/path/to/aws-bedrock-logs-mcp", "run", "cloudwatch_mcp_server.py" ] } } } 确保将目录路径替换为实际路径。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。