Baryhuang MCP Server Aws Resources Python

🚀 AWS 資源 MCP 服務器

這是一個由 Python 實現的 AWS 資源 MCP 服務器，藉助 boto3 庫對 AWS 資源進行查詢和管理。該服務器支持 S3、EC2、DynamoDB 等多種 AWS 服務，還能通過 Docker 容器運行，為 AWS 資源管理提供了簡單靈活的解決方案。

🚀 快速開始

配置 AWS 憑證

確保在運行容器前已正確配置 AWS 憑證（訪問密鑰 ID 和秘密訪問密鑰）。

選擇區域

可以通過設置 AWS_DEFAULT_REGION 環境變量來指定默認區域，或在調用中顯式指定區域。

使用 API

通過發送 HTTP 請求到 MCP 服務器，幷包含所需的 AWS 操作和參數。

✨ 主要特性

支持的服務

• S3：可進行列出桶、上傳/下載文件等操作。
• EC2：能查詢實例狀態、啟動/停止實例等。
• DynamoDB：支持讀寫表數據、查詢索引等操作。
• IAM：可管理用戶和權限。

輕量級與易集成

與現有的工具相比，本項目的實現更加輕量級且易於集成到各種環境中。

📦 安裝指南

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
   

💻 使用示例

基礎用法

示例查詢

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

# 查詢 EC2 實例狀態
{
  "operation": "describe_instances",
  "params": {
    "InstanceIds": ["i-12345678"]
  }
}

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

示例代碼

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 資源。