🚀 AWS 资源 MCP 服务器

本项目的 AWS 资源 MCP 服务器，允许用户通过 Claude Desktop 对 AWS 资源进行查询和操作，为 AWS 资源管理提供了便捷途径。

🚀 快速开始

本文档详细介绍了如何设置和使用 AWS 资源 MCP 服务器，让您能通过 Claude Desktop 轻松查询和操作 AWS 资源。

📦 安装指南

方法一：从 Docker 镜像仓库拉取

docker pull buryhuang/mcp-server-aws-resources:latest

方法二：本地构建

docker build -t mcp-server-aws-resources .

💻 使用示例

运行容器

基础用法

示例 1：使用 ACCESS_KEY_ID 和 SECRET_ACCESS_KEY

docker run \
  -e AWS_ACCESS_KEY_ID=your_access_key_id_here \
  -e AWS_SECRET_ACCESS_KEY=your_secret_access_key_here \
  -e AWS_DEFAULT_REGION=us-east-1 \
  buryhuang/mcp-server-aws-resources:latest

示例 2：使用 PROFILE 并挂载本地 AWS 凭据

docker run \
  -e AWS_PROFILE=default \
  -v ~/.aws:/root/.aws \
  buryhuang/mcp-server-aws-resources:latest

多平台发布

基础用法

1. 创建新的构建器实例（如果尚未创建）：

docker buildx create --use

2. 构建并推送到多个平台：

docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-server-aws-resources:latest --push .

3. 验证镜像是否在指定平台上可用：

docker buildx imagetools inspect buryhuang/mcp-server-aws-resources:latest

在 Claude Desktop 上使用

基础用法

示例 1：使用 Docker 运行，使用 ACCESS_KEY_ID 和 SECRET_ACCESS_KEY

{
  "mcpServers": {
    "aws-resources": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AWS_ACCESS_KEY_ID=your_access_key_id_here",
        "-e",
        "AWS_SECRET_ACCESS_KEY=your_secret_access_key_here",
        "-e",
        "AWS_DEFAULT_REGION=us-east-1",
        "buryhuang/mcp-server-aws-resources:latest"
      ]
    }
  }
}

示例 2：使用 Docker 运行，使用 PROFILE 和挂载本地 AWS 凭据

{
  "mcpServers": {
    "aws-resources": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AWS_PROFILE=default",
        "-v",
        "~/.aws:/root/.aws",
        "buryhuang/mcp-server-aws-resources:latest"
      ]
    }
  }
}

示例 3：使用 Git 克隆代码运行，使用 PROFILE 运行

{
  "mcpServers": {
    "aws": {
      "command": "/Users/gmr/.local/bin/uv",
      "args": [
        "--directory",
        "/<your-path>/mcp-server-aws-resources-python",
        "run",
        "src/mcp_server_aws_resources/server.py",
        "--profile",
        "testing"
      ]
    }
  }
}

📚 详细文档

注意事项

⚠️ 重要提示

1. 请确保 AWS 凭据的安全性，避免泄露。
2. 运行命令前，请确认 Docker 已安装且版本兼容。
3. 运行容器时需要稳定的网络连接。

希望本文档能帮助您顺利设置和使用 AWS 资源 MCP 服务器！