AWS 资源 MCP 服务器

项目概述

这是一个由 Python 实现的 AWS 资源 MCP 服务器，旨在通过 boto3 库查询和管理 AWS 资源。该服务器支持多种 AWS 服务，包括 S3、EC2、DynamoDB 等，并可以通过 Docker 容器运行。

为什么创建另一个 AWS MCP 服务器

我们创建这个项目的原因是希望提供一个更简单、更灵活的解决方案来管理和查询 AWS 资源。与现有的工具相比，我们的实现更加轻量级且易于集成到各种环境中。

组件和功能

支持的服务

• S3: 列出桶、上传/下载文件等操作。
• EC2: 查询实例状态、启动/停止实例等操作。
• DynamoDB: 读写表数据、查询索引等操作。
• IAM: 管理用户和权限。

示例查询

# 列出所有 S3 桶
{
  "operation": "list_buckets",
  "params": {}
}

# 查询 EC2 实例状态
{
  "operation": "describe_instances",
  "params": {
    "InstanceIds": ["i-12345678"]
  }
}

安装和使用

Docker 安装

支持平台

• Linux/amd64
• Linux/arm64
• Linux/arm/v7

方案 1: 从 Docker Hub 拉取

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

方案 2: 本地构建

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

运行容器：

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

或者使用配置文件和本地凭证：

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

Docker 运行示例

示例 1：使用 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：使用 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"
      ]
    }
  }
}

使用说明

1. 配置 AWS 凭证：确保在运行容器前已正确配置 AWS 凭证（访问密钥 ID 和秘密访问密钥）。
2. 选择区域：可以通过设置 AWS_DEFAULT_REGION 环境变量来指定默认区域，或在调用中显式指定区域。
3. 使用 API：通过发送 HTTP 请求到 MCP 服务器，并包含所需的 AWS 操作和参数。

示例代码

import requests

# 初始化 MCP 服务器地址
mcp_server_url = "http://localhost:5000"

# 列出 S3 桶
response = requests.post(mcp_server_url, json={
    "operation": "list_buckets",
    "params": {}
})
print(response.json())

# 查询 EC2 实例状态
response = requests.post(mcp_server_url, json={
    "operation": "describe_instances",
    "params": {
        "InstanceIds": ["i-12345678"]
    }
})
print(response.json())

注意事项

• 确保 AWS 凭证的安全性，避免泄露。
• 定期更新依赖库以获取最新的功能和安全修复。

通过以上步骤，您可以轻松地在本地或云环境中部署并使用这个 MCP 服务器来管理和查询 AWS 资源。