Back to MCP directory
publicPublicdnsLocal runtime

mcp-server-aws-resources-python

一个基于MCP协议的AWS资源查询服务器,通过Docker容器提供安全的Python执行环境,支持通过boto3查询和管理AWS资源。

article

README

🚀 AWS 资源 MCP 服务器

本项目的 AWS 资源 MCP 服务器,可让您借助 Claude Desktop 对 AWS 资源进行查询与操作,为用户提供了便捷的资源管理途径。

🚀 快速开始

按照以下步骤,您可以轻松设置并使用 AWS 资源 MCP 服务器。

📦 安装指南

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

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

方法二:本地构建

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

💻 使用示例

运行容器

基础用法

使用 ACCESS_KEY_IDSECRET_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

高级用法

使用 PROFILE 并挂载本地 AWS 凭据运行容器:

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

多平台发布

基础用法

创建新的构建器实例(若尚未创建):

docker buildx create --use

高级用法

构建并推送到多个平台:

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

验证镜像是否在指定平台上可用:

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

在 Claude Desktop 上使用

使用 Docker 运行

基础用法

使用 ACCESS_KEY_IDSECRET_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"
      ]
    }
  }
}
高级用法

使用 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"
      ]
    }
  }
}

使用 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"
      ]
    }
  }
}

⚠️ 重要提示

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

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

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client