AWS S3对象管理平台

@OpenWorkspace-o1/aws-ow-s3-mcp
0 Stars 65 次浏览 OpenWorkspace-o1 更新于 2026-08-23

通过预签名的URL提供对AWS S3存储桶的安全访问，支持列出、下载、上传和删除对象。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "aws-ow-s3-mcp": {
      "args": [
        "-y",
        "@modelcontextprotocol/server-aws-ow-s3-mcp"
      ],
      "command": "npx",
      "env": {
        "AWS_ACCESS_KEY_ID": "\u003cYOUR_ACCESS_KEY\u003e",
        "AWS_SECRET_ACCESS_KEY": "\u003cYOUR_SECRET_KEY\u003e",
        "BUCKET_NAME": "\u003cYOUR_BUCKET_NAME\u003e",
        "REGION": "\u003cAWS_REGION\u003e"
      }
    }
  }
}

该服务需要配置环境变量：AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、BUCKET_NAME、REGION

服务介绍

AWS S3 MCP 服务器

用于 AWS S3 操作的 MCP 服务器，通过预签名 URL 提供对 S3 存储桶的安全访问。

工具

  1. list_objects

    • 列出 S3 存储桶中的对象
    • 输入：
      • prefix (字符串, 可选): 对象键的前缀过滤器
    • 返回: 包含键、大小和最后修改日期的对象数组

  2. get_object

    • 生成用于访问对象的预签名 URL
    • 输入：
      • key (字符串, 必需): 要检索的对象键
      • expiry (数字, 可选): URL 的过期时间（秒）(默认: 3600)
    • 返回: 包含预签名 URL 的 object_url

  3. put_object

    • 生成用于上传对象的预签名 URL
    • 输入：
      • key (字符串, 必需): 要上传的对象键
      • expiry (数字, 可选): URL 的过期时间（秒）(默认: 3600)
    • 返回: 包含预签名 URL 的 upload_url

  4. delete_object

    • 从存储桶中删除一个对象
    • 输入：
      • key (字符串, 必需): 要删除的对象键
    • 返回: 表示删除状态的布尔值 success

设置

环境变量

服务器需要以下环境变量：

  • BUCKET_NAME: 您的 S3 存储桶名称（必需）
  • REGION: AWS 区域（默认: "ap-southeast-1"）

AWS 凭证应使用标准的 AWS 凭证配置方法进行配置（环境变量、IAM 角色或 AWS 凭证文件）。

与 Claude Desktop 一起使用

将以下内容添加到您的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "aws-ow-s3-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BUCKET_NAME",
        "-e",
        "REGION",
        "-e",
        "AWS_ACCESS_KEY_ID",
        "-e",
        "AWS_SECRET_ACCESS_KEY",
        "mcp/aws-ow-s3-mcp"
      ],
      "env": {
        "BUCKET_NAME": "<YOUR_BUCKET_NAME>",
        "REGION": "<AWS_REGION>",
        "AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY>",
        "AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_KEY>"
      }
    }
  }
}

NPX 命令

{
  "mcpServers": {
    "aws-ow-s3-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-aws-ow-s3-mcp"
      ],
      "env": {
        "BUCKET_NAME": "<YOUR_BUCKET_NAME>",
        "REGION": "<AWS_REGION>",
        "AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY>",
        "AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_KEY>"
      }
    }
  }
}

构建

Docker 构建：

docker build -t mcp/aws-ow-s3-mcp-server .

开发

该服务器使用以下技术构建：

  • Node.js
  • TypeScript
  • @modelcontextprotocol/sdk
  • @aws-sdk/client-s3
  • @aws-sdk/s3-request-presigner

许可证

此 MCP 服务器根据 MIT 许可证许可。这意味着您可以自由地使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。

查看源码 项目主页